Hiddify 无法导入订阅：Failed to Add Profile 排查指南
解决 Hiddify 导入订阅时出现 Failed to Add Profile、Unexpected Connection Error 或无法识别订阅类型的问题。
导入订阅时出现 Failed to Add Profile、Unexpected Connection Error，或“无法确定订阅链接类型”，并不等于节点一定失效。错误可能发生在下载订阅、验证 HTTPS、识别内容格式或保存配置中的任一步。
官方仓库已有 Windows 用户报告相同错误：Issue #1661记录了 Failed to Add Profile / Unexpected Connection Error，Issue #2037则记录了 Clash 格式订阅无法识别。它们是用户案例，不代表所有设备共享同一个根因。
症状
- 点击“从剪贴板添加”后立即报错。
- 手动输入 URL 后出现意外连接错误。
- 链接在旧版本或另一台设备能导入，在当前设备失败。
- 应用提示无法确定订阅类型，或导入后没有任何节点。
- “检查更新”和“添加配置”同时出现网络错误。
如果配置已经存在、只是刷新失败，请改看订阅更新失败指南。
两分钟快速判断
- 重新从服务商后台复制订阅地址，确认它以
https://或受支持的单节点协议开头，且没有空格、换行或遗漏字符。 - 不要公开链接。在可信浏览器中访问该 HTTPS 地址，观察它是返回配置内容，还是跳到登录、验证码、错误或证书警告页面。
- 在 Wi-Fi 与手机热点之间切换一次。如果只在某个网络失败，优先检查 DNS、TLS 或该网络的访问限制。
- 在另一台设备导入同一链接，或在当前设备导入另一个已知有效的订阅。用交叉结果区分设备问题和订阅问题。
- 记录完整报错文字和时间，不要连续重装、切换内核并改动所有高级设置。
分层排查
客户端：确认输入方式和版本
官方文档提供两种基本方式：从剪贴板添加，或手动填写名称与 URL；具体步骤见官方 HiddifyApp 使用说明。
- 先把链接粘贴到本地纯文本编辑器，检查开头、结尾和意外换行，再立即清除该临时文本。
- 剪贴板添加失败时，用“手动添加”输入同一条完整 URL；这只用于排除剪贴板内容问题。
- 核对官方 Releases中的当前稳定版本和对应平台安装包。
- 升级前保留现有可用配置。不要把“清除应用数据”当作第一步，因为它可能删除唯一可用的本地配置。
- 某些 Issue 评论中的“打开调试模式”只是个别用户经验，并非通用修复；调试模式的主要价值是获得更明确的错误日志。
订阅：确认返回的是配置，而不是网页
- 检查账号有效期、剩余流量和同时在线设备限制。
- 确认复制的是“订阅链接”，不是服务商面板首页、付款页或教程页。
- 如果浏览器返回 HTML 登录页、验证码、WAF 拦截页、空白页或错误 JSON，应由服务商修复响应。
- 如果链接声明为 Clash、Sing-box 或单节点格式，返回内容必须与声明一致。官方说明列出了 Hiddify 支持的多种订阅和协议格式，但“受支持”不等于任何文本都能被解析。
DNS/TLS：保留 HTTPS 安全边界
- 校准操作系统日期、时间和时区。
- 检查浏览器是否报告域名不匹配、证书过期、证书链不受信任或 TLS 握手失败。
- 先换网络复测，再根据日志处理 DNS；不要把证书问题误判成节点故障。
- 不要关闭系统证书校验，也不要安装来源不明的根证书。
绝对不要把订阅从
https://改为http://。 即使某条用户评论把它描述为临时办法，HTTP 会明文暴露订阅 Token 和节点信息。Hiddify 的官方 HISTORY 还明确记录了 4.x 禁用 HTTP 订阅链接的安全决定：查看变更记录。
服务端：让提供者检查实际响应
如果多个设备和多个网络都不能导入同一链接，请让服务商检查：
- HTTPS 证书是否有效且证书链完整；
- 请求是否返回 200，还是 3xx 循环、401、403、404 或 5xx；
- 重定向后的域名和协议是否仍然安全可达；
- 返回体是否是有效的 Clash、Sing-box 或节点配置；
- Token、账号、流量和设备限制是否有效。
服务商如需迁移订阅域名，可参考 Hiddify 官方 URL Scheme 文档中的 moved-permanently-to 机制，而不是要求用户降级为 HTTP。
验证
问题解决后，应同时满足：
- 删除测试产生的重复配置，但保留确认可用的配置。
- 用同一 HTTPS 链接连续导入或刷新三次，不再出现原错误。
- 配置能显示节点，且至少一个节点可完成延迟测试和实际网页访问。
- 重新启动应用后配置仍存在。
- 日志中不再出现同一下载、证书或解析错误。
导入成功但连接后没有网络，继续阅读Hiddify 已连接但无法上网。
何时联系服务商
出现以下任一情况时，直接联系订阅服务商：浏览器证书警告、链接返回登录/错误页、账号过期、多个客户端都无法读取，或同一服务商的多个节点同时失效。
若同一链接在其他客户端和设备正常，只有特定 Hiddify 版本稳定失败，可向官方 Issue 区提交：系统版本、Hiddify 版本、安装来源、错误原文、复现步骤和脱敏日志。不要提交完整订阅 URL、Token、UUID、二维码或服务器凭据。