节点手册NODE HANDBOOK
Hiddify 故障

Hiddify 导入报 unknown field "tunnel-per-resolver":先查配置字段

Hiddify 导入订阅时提示 SingboxParser unknown field tunnel-per-resolver,按获取、配置解析和连接阶段分流,保留原配置并核对来源格式。

资料核验:2026-11-11 · 发布:2026-11-11T02:30:17+08:00(北京时间)

Hiddify 添加或更新订阅时,如果明确出现 [SingboxParser] unmarshal error 和 unknown field "tunnel-per-resolver",故障发生在配置解析阶段。先保留原订阅和旧配置,记录报错指向的 outbounds[n],再向订阅提供方核对该字段和目标客户端格式。此时反复切换节点、测延迟或改系统代理,无法解决尚未导入的配置。

资料核验:2026-11-11(北京时间)。Hiddify 官方仓库的 Issue #2295 记录 Android 16、Hiddify 4.1.1 导入 Hiddify Manager 订阅时报 outbounds[33].tunnel-per-resolver;Issue #2203 记录 Windows 11、Hiddify 4.1.1 对另一份订阅报相近字段错误。两项都是用户报告,已关闭的状态不等于给出了通用修复版本。本文未取得这两份私人订阅,也没有复现其完整配置。

先看错误停在哪一步

看到的结果 所在阶段 先做什么
超时、TLS 错误或 HTTP 401/403,尚未取得配置 获取失败 回到订阅更新总排查核对地址、授权和网络
已收到内容,随后出现 SingboxParser、outbounds[n] 与 unknown field "tunnel-per-resolver" 内容到了客户端,但当前解析器不接受该字段 保存脱敏报错、版本和订阅类型,联系提供方核对输出格式
没有解析错误,配置已导入但列表为空 导入后的展示或选择阶段 看Hiddify 更新后无节点
节点已经出现,连接才失败 核心启动、节点或网络阶段 保留最早的连接日志,按对应错误排查,不再反复导入

错误里的 outbounds[33] 或 outbounds[25] 是配置数组中的位置,用于定位那一项,不是第 33 或第 25 个节点已失效的证明。unknown field 只说明当前解析路径不接受这个字段;它本身不能区分是订阅生成器输出了不适用字段、客户端版本与配置格式不匹配,还是内容在传递中被改写。

按顺序处理

  1. 保留当前可用配置。 暂停自动更新或频繁重试,记下系统、Hiddify 版本、订阅来源类型、报错全文与北京时间。不要清空应用数据,也不要公开完整订阅 URL。
  2. 确认是获取成功后的解析错误。 若日志先显示 HTTP、证书、连接或权限错误,按获取失败处理;若显示 SingboxParser 和字段名,再继续本页。HTTP 200 也可能返回登录页,所以需要同时核对内容类型。
  3. 核对提供方给出的导入入口。 看提供方是否区分 Hiddify、sing-box、Clash 或通用链接;使用明确面向当前客户端的入口,避免把网页、二维码跳转页或另一种客户端格式当作配置。不要把私人订阅贴到在线转换站。
  4. 仅在可信本机检查脱敏结构。 如果你有权查看原始配置,用本地 JSON/YAML 解析器核对报错指出的 outbounds[n] 附近字段是否确实出现 tunnel-per-resolver,同时保留原文件副本。不要随意删字段再把改过的配置当作来源方原始结果;某个字段可能与其他设置有关。
  5. 联系订阅提供方。 只发送脱敏后的字段名、数组位置、客户端版本、系统、错误时间与入口类型,请其核对配置生成器输出是否适配该版本。若提供方给出修正的专用订阅,先并行导入测试,确认可解析、节点出现、实际 HTTPS 请求成功,再决定是否替换旧配置。

上述两条 Issue 的问题描述没有给出可直接套用的修复步骤。升级客户端前应先看官方 Releases与版本说明并备份配置;不能承诺“升级必好”,也不能根据个别报告建议所有人降级。sing-box 的出站配置文档可作为核对字段类型和结构的资料,但 Hiddify 的实际导入器仍以其版本实现为准。

修复后怎样确认

导入不再报错只是第一步。继续确认目标配置已保存并选中、列表中出现预期节点、核心能够启动,再用自己可访问的 HTTPS 站点做一次实际请求。若仍是“配置名存在但无节点”,转到无节点分层排查;若节点存在但无法上网,转到首次连接流程核对接管方式和实际网络。需要比较公开临时节点与付费服务时,分别查看免费节点测试记录和机场评级入口,不要用“能导入”推断长期稳定性。

范围与限制

这里的判断只适用于报错明确包含 SingboxParser 和 unknown field "tunnel-per-resolver" 的情形。adress 拼写错误、其他 unknown field、订阅获取失败及连接后断网,可能需要不同处理。本站没有两份 Issue 中的私人配置和服务端生成器资料,不能断言具体哪一端有缺陷,也不能承诺某版本、某个字段改动或某个提供方入口一定解决问题。公开求助时应遮盖订阅 URL、令牌、UUID、节点服务器和账号信息。

常见问题

outbounds[33] 表示第 33 个节点坏了吗?

不能这样判断。它首先是解析器给出的数组位置;在配置未成功导入前,单凭这个数字不能证明节点可用性。

为什么浏览器能打开订阅,Hiddify 还是报错?

浏览器能打开只说明该访问路径可能取得了内容。客户端还要识别响应、解析字段并建立配置;先比较内容类型和脱敏错误,别公开订阅正文。

能不能直接删掉 tunnel-per-resolver?

不要在唯一原件上直接改。字段的作用和来源需要由生成配置的一方核对;即使删除后能解析,也要验证核心启动、实际请求和所需功能,不能把“解析通过”当作完整修复。

是不是更新 Hiddify 就能解决?

这两条问题描述没有证明存在适用于所有环境的修复版本。先备份,并对照自己版本的发布说明;更新后仍需在同一订阅上复测。

这个错误和“更新后没有节点”是同一件事吗?

不完全相同。本页先处理明确的字段解析错误;没有解析错误但节点列表为空,才按获取、内容、选择和启动阶段继续排查。

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