Clash Verge
订阅管理 · v2.5.5
Clash Verge 订阅导入失败：4 类原因与排查顺序
按请求失败、鉴权失效、缓存路径共用、格式不符四类归类订阅导入失败的原因，附日志原文特征与逐项排查顺序。
适用版本：v2.5.5
更新日期：2026-09-23
来源：官方 Releases、文档与公开 issue
第 1 类：请求无法完成
表现为导入后长时间无响应或提示网络错误。常见原因是订阅链接本身不可达、被本地网络拦截、或链接带重定向。排查方式是先用浏览器直接打开订阅链接，确认能返回内容，再回到客户端重新导入。
如果链接在本地可达但客户端不可达，需要检查系统代理与 TUN 是否处于开启状态——客户端自身的请求也可能被已有规则接管，造成循环依赖。
第 2 类：鉴权失效
表现为返回 4xx 状态码或内容为空。订阅服务通常带有效期与流量限制，过期或被停用后链接仍可访问但不再返回节点内容。这类问题在客户端侧无法通过重试解决，需要联系订阅提供方或更换链接。
第 3 类：缓存路径共用
多个订阅共用同一缓存目录时，后导入的会覆盖前一个的内容，表现为节点数量不对或配置错乱。排查方式是查看配置文件目录中各订阅对应的缓存文件，确认文件名是否互相冲突。
第 4 类：格式不符
Clash Verge 沿用 Clash 配置格式，订阅内容需要是符合 YAML 结构的配置片段。若提供方返回的是其他格式或经过二次加密的内容，导入会直接失败。这类情况需要确认订阅链接是否为 Clash 专用格式。
常见问题
导入成功但节点数为 0 算失败吗？
通常属于第 2 类或第 4 类：链接返回了内容但内容中没有可用节点，或格式不被解析。建议把订阅链接内容复制到本地查看，确认其中是否包含 proxies 字段。
多个订阅会互相覆盖吗？
正常情况各自独立缓存。若出现覆盖，多为缓存路径共用导致，检查配置目录中的缓存文件命名即可确认。