节点手册NODE HANDBOOK
Hiddify macOS 数据库故障

Hiddify macOS 导入订阅报 duplicate column name: profile_override 怎么办?

Hiddify macOS 报 duplicate column name: profile_override 并指向 profile_entries 时,先按 SQLite 数据库迁移错误保护原数据,再只读检查 schema。

资料核验:2026-11-18 · 约8分钟阅读

资料核对: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 在新列名与同一表已有列名冲突时会报错。因此,错误可以支持“迁移语句碰到重复目标列”的判断,却不能单凭报错识别为什么数据库处于该状态,也不能证明订阅内容有问题。

安全收集信息

  1. 记录 Hiddify 完整版本号、macOS 版本、错误出现时的操作,以及此前是否升级、迁移或从备份恢复。只记录重现步骤,不要公开订阅链接、访问令牌或数据库文件。
  2. 完全退出 Hiddify。找到日志实际提到的数据库文件位置;不同安装和版本的数据路径可能不同,不要假定每个人都使用 ~/Library/db.sqlite。
  3. 先把数据库复制到离线备份位置,并保留原件。本站没有验证备份完整性或恢复能力;文件大小非零不代表备份可用。不要在应用仍运行时复制或编辑数据库,也不要先删数据目录、卸载后清理残留或覆盖旧备份。
  4. 如熟悉 SQLite,可对副本作只读检查。下面的路径必须替换为你确认过的副本绝对路径:
sqlite3 'file:/绝对路径/db.sqlite?mode=ro' 'PRAGMA user_version;'
sqlite3 'file:/绝对路径/db.sqlite?mode=ro' 'PRAGMA table_info(profile_entries);'
  1. 若检查结果显示 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 订阅更新后没有节点、订阅更新失败排查、连接检查表。

也可以前往全部文章浏览。