资料核对:2026-11-18(北京时间)。本文处理 Hiddify macOS 出现 duplicate column name: profile_override,并指向 profile_entries 与 SQLite ALTER TABLE ... RENAME COLUMN 的情况。该错误首先指向本地数据库迁移;单凭它不能判断订阅、节点或网络是否正常。依据是 Hiddify 官方仓库仍开放的 Issue #2078、该议题后续评论和 SQLite 官方文档;本站没有用户数据库,也未复现故障。
先判断问题在哪一层
错误中的 ALTER TABLE 指向应用数据库结构迁移。Issue #2078 最初报告为 macOS Monterey、Hiddify 4.1.1,导入剪贴板订阅时出现错误;后续用户在 Hiddify 5.5.5 的 macOS 上报告相同列名冲突,且影响启动。该用户披露的数据库检查结果为 user_version = 4,profile_entries 同时已有 test_url 与 profile_override。两个报告的触发时机和数据库状态不同,不能据此断言只有导入动作或某一类数据库会遇到问题。
| 看到的现象 | 优先判断 | 下一步 |
|---|---|---|
明确出现 duplicate column name: profile_override 和 ALTER TABLE "profile_entries" RENAME COLUMN |
SQLite schema 迁移与现存列名冲突 | 先保留原件并尝试可恢复的离线备份,再收集应用版本、macOS 版本及只读 schema 信息 |
duplicate column 指向别的表或列 |
可能是另一条迁移或不同版本问题 | 保留完整错误里的表名、列名、SQL 和版本,不能套用本文结论 |
invalid yaml、Failed to import subscription content 或 HTTP 错误 |
订阅获取或解析阶段 | 按订阅更新失败排查分流 |
| 导入成功、节点出现,但连接后请求失败 | 代理连接或本机网络阶段 | 按连接检查表记录同一网络下的真实请求 |
SQLite 的 RENAME COLUMN 在新列名与同一表已有列名冲突时会报错。因此,错误可以支持“迁移语句碰到重复目标列”的判断,却不能单凭报错识别为什么数据库处于该状态,也不能证明订阅内容有问题。
安全收集信息
- 记录 Hiddify 完整版本号、macOS 版本、错误出现时的操作,以及此前是否升级、迁移或从备份恢复。只记录重现步骤,不要公开订阅链接、访问令牌或数据库文件。
- 完全退出 Hiddify。找到日志实际提到的数据库文件位置;不同安装和版本的数据路径可能不同,不要假定每个人都使用
~/Library/db.sqlite。 - 先把数据库复制到离线备份位置,并保留原件。本站没有验证备份完整性或恢复能力;文件大小非零不代表备份可用。不要在应用仍运行时复制或编辑数据库,也不要先删数据目录、卸载后清理残留或覆盖旧备份。
- 如熟悉 SQLite,可对副本作只读检查。下面的路径必须替换为你确认过的副本绝对路径:
sqlite3 'file:/绝对路径/db.sqlite?mode=ro' 'PRAGMA user_version;'
sqlite3 'file:/绝对路径/db.sqlite?mode=ro' 'PRAGMA table_info(profile_entries);'
- 若检查结果显示
profile_entries已有profile_override,记录只读输出及错误截图中的 SQL 行,再通过 Hiddify 官方 Issue #2078 报告版本、操作经过和脱敏信息。PRAGMA table_info的结果不是修复指令;不要把表结构输出、数据库或日志中可能含有的令牌贴到公开讨论。
不要盲目跳过迁移
Issue #2078 的一条后续评论描述了一个 Hiddify 5.5.5 案例:备份后把 PRAGMA user_version 从 4 改成 5,该用户随后能正常打开应用。这个操作会改变迁移版本标记,等于告诉应用某个迁移已经完成,但没有证明当前库里所有改动都已完成或数据一致。它只是一位用户在特定数据库上的观察,不是官方通用修复;不要照抄执行,也不要在未经验证时编辑 schema、删 db.sqlite 或继续导入唯一的订阅来源。
截至 2026-11-18,北京时间核验的 Hiddify 官方仓库最新发布标签为 v5.5.5;Issue #2078 仍为开放状态,评论中仍报告该版本出现相关错误。公开资料没有给出维护者确认的通用修复版本,也没有足够信息判断每种数据库状态。更新软件可以作为常规排查的一项,但不能承诺升级一定修复;升级前先备份,并保留当前版本及错误信息。
适用范围与限制
本文只适用于 macOS 上能看到 profile_entries 与 profile_override 这组错误文字的情况。Issue #2078 是用户报告,不是维护者确认的普遍缺陷或根因分析。原始报告提到 Hiddify 4.1.1,后续报告提到 5.5.5;后续报告描述了不同触发阶段和数据库状态,不能合并成已验证复现。本站没有验证 issue 评论里的 user_version 改动,没有数据库样本,也没有经过恢复演练。遇到不同表名、列名、系统或客户端,应以实际日志和当前官方发布说明重新判断。
常见问题
这是订阅链接坏了或节点失效吗?
错误文本指向 SQLite 表结构迁移,不是代理请求失败。先处理本地数据库证据;不要公开订阅令牌,也不要仅因这条错误反复更换节点。
为什么同时看到“导入失败”和“启动黑屏”的报告?
Issue #2078 不同用户在不同版本描述了不同触发时机。它们共享列名冲突文本,但不是本站复现的同一状态链。记录发生在启动前还是导入时,避免把两个案例写成同一个确定根因。
把 user_version 改成 5 是否可以照做?
不建议照抄。评论只记载一位用户在其现有数据库上的结果;跳过迁移会绕开应用的数据转换逻辑,其他数据库状态可能不兼容。
删除 db.sqlite 后重新导入能解决吗?
没有证据支持它是通用修复,而且可能丢失配置、历史和本地状态。先确认数据库路径并备份,保留原件,再根据官方讨论和新版本说明行动。
这是否只影响 macOS Monterey?
现有两个案例都来自 macOS,其中一个后续案例报告 Darwin 24.6.0 与 Hiddify 5.5.5;数据不足以判断其他系统是否受影响,也不能推断所有 Monterey 用户都会遇到。
来源
- Hiddify 官方仓库 Issue #2078,及其后续评论;核对时间:2026-11-18 北京时间,状态为 open。
- SQLite ALTER TABLE 官方文档,用于核对列重命名和目标列冲突的语义。
- SQLite PRAGMA 官方文档:table_info,用于说明只读检查表列信息的方法。
- Hiddify 官方发布页,核对时最新标签为
v5.5.5;官方 APIpublished_at为2026-11-04T21:06:14Z(UTC),即北京时间 2026-11-05 05:06:14。
相关排查:Hiddify 订阅更新后没有节点、订阅更新失败排查、连接检查表。