订阅无法导入时,先判断失败发生在下载、格式解析还是配置加载阶段。完整 URL、客户端对应的订阅格式、账户状态和网络连通性是优先检查项;反复换节点通常不能修复订阅本身的解析问题。
先保存脱敏错误信息
记录客户端与核心版本、操作时间、网络、所选订阅格式和完整错误文本。分享时隐藏 URL 中的令牌和查询参数值。不要把订阅上传到公开转换网站来“试试看”,那可能泄露整个账户的使用权限。
下载阶段失败
- 确认复制了完整地址,没有空格、换行、引号或聊天软件添加的标点。
- 检查服务商后台是否提供了新的地址,账户是否到期或令牌已重置。
- 用当前网络验证服务商后台和订阅域名是否可访问,比较手机热点与宽带。
- 查看客户端是否尝试通过一个已失效代理获取订阅。首次获取和后续更新的网络路径可能不同。
DNS 失败、超时、TLS 报错和 HTTP 状态码分别指向不同层次。浏览器能访问官网不代表订阅地址也能工作,它们可能使用不同域名。
收到响应但无法解析
HTTP 200 也可能返回登录页面、验证码页面、配额提示或错误文本。先在受控环境中查看响应类型,不要公开粘贴响应正文,因为其中可能包含所有节点密码。
Mihomo YAML、Stash 配置和编码节点列表并不完全可互换。检查服务商给你的链接是否对应客户端;单个 ss 或 vless 分享链接也不能当成 HTTP 订阅 URL。不要只给文件改扩展名。
解析成功但加载失败
未知协议、字段或传输组合,可能来自客户端或核心版本不支持。配置中的规则、策略组和外部资源也要匹配:不存在的策略组名称、无法下载的 provider 资源都可能导致加载失败。
先恢复已知可用的配置副本。升级前查看官方兼容说明,不删除不认识的安全参数来强行通过校验。
一个排查记录示例
“2026-10-01,Windows,客户端版本与核心版本已记录;宽带请求超时,热点能下载但提示不支持字段;已确认选错订阅格式。”这比“机场坏了”更容易让支持人员定位。示例不代表某服务的实测结果。
仍不能解决时,向服务商询问订阅返回格式、账户状态及受支持的客户端版本。只提交脱敏日志和时间,不提交公开令牌。