01为什么三种失败看起来一模一样
多数客户端在订阅拉取失败时，只告诉你“失败了”，不告诉你为什么。这个设计初衷可以理解——报错信息太专业，普通用户看不懂反而更困惑。但代价是：你把三种完全不同的失败当成了同一种来处理。
链接过期的正确做法是换链接；网络不可达的正确做法是换网络；格式不匹配的正确做法是做订阅转换。如果你把网络问题当成链接过期来处理，就会陷入“换了十次链接还是失败”的循环。
订阅拉取失败时，不要立刻换链接。先花三十秒判断属于哪一类，再决定动什么。这一步做对，后面会快很多。
02三张面孔：各自的特征与修复动作
下面把三种失败按特征、典型报错、修复动作三个维度拆开。看的时候对照自己的情况，先对号入座，再翻到对应的修复面板。
特征：昨天还能用的订阅，今天突然拉不下来。或者你刚从某个渠道拿到的链接，第一次导入就失败。
本质：订阅 URL 后面的令牌失效了。服务端不再认识这个令牌，直接拒绝请求。
HTTP 404 / 403 · Invalid token特征：同一个链接在另一台设备上能用，在这台设备上不行。或者换了网络环境（比如手机热点）就能拉下来。
本质：请求根本没到达订阅服务器，卡在中间某一跳。DNS 解析失败、域名被污染、出口被阻断都可能。
Timeout · Connection refused · DNS failed特征：链接能拉取，日志里能看到 HTTP 200 返回，但客户端解析后节点列表为空，或者提示“配置文件无效”。
本质：拿到了内容，但内容不是 Clash 系 YAML 格式。可能是 V2Ray 的 base64 编码，也可能是别家的配置格式。
HTTP 200 · YAML parse error · Empty proxies03一张决策树：先问自己三个问题
不用记特征表，直接按下面这棵树走。每个问题只需要回答“是”或“否”，走到底就知道是哪一类。
订阅失败 · 诊断决策树
按顺序回答，不需要跳步
这个订阅链接，之前在同一台设备上成功拉取过吗？
先往链接过期和网络变化两个方向查。翻到修复面板一和面板二，按顺序排查。
先确认链接本身是否有效，再确认格式是否匹配。优先走修复面板三（格式校验），因为首次导入最常见的坑是格式不对。
换一个网络环境（比如手机热点），链接能拉取成功吗？
问题在当前网络环境。属于“网络不可达”。翻到修复面板二，从 DNS 和出口两个方向排查。
大概率不是网络问题。回到链接本身或格式，翻到修复面板一或面板三。
把订阅链接粘贴到浏览器地址栏，能看到内容吗？
说明链接本身没问题，网络也通。看内容是什么格式——如果是一长串乱码般的字符，多半是 base64 编码，需要做订阅转换。
说明问题在链接或网络层面，不在客户端。链接可能已过期，或者当前网络无法访问该域名。
04修复面板一：链接过期
链接过期 · 换个链接就好
链接过期是三种情况里最简单的一种，因为处理动作很直接：从服务提供方那里重新获取一条新链接。旧的链接已经作废，再怎么折腾也拉不下来。
- ✓登录订阅服务方的用户中心，找到“重新生成订阅链接”或“重置订阅”按钮
- ✓复制新链接，替换客户端里旧的订阅地址，重新拉取
- ✓如果服务方提供订阅到期时间，顺便确认一下是否已到期需要续费
一个小技巧：订阅链接通常很长，手动复制容易漏字符。建议用剪贴板直接粘贴，不要手打。如果客户端支持扫码导入，用二维码比复制粘贴更可靠。
05修复面板二：网络不可达
网络不可达 · 换路径而不是换链接
网络不可达的核心特征是：换网络环境后，同一个链接就能用了。这说明链接本身有效，问题出在“请求送不出去”或“送不到正确的地址”。
- ✓先换网络试一次。用手机热点替代当前 Wi-Fi，再点一次订阅更新。能成功就说明是当前网络的问题
- ✓检查 DNS 解析。在当前网络下 ping 一下订阅域名，看是否能解析出 IP。解析失败通常与 DNS 有关
- ✓临时关闭 TUN 模式。TUN 接管全部流量后，有时会与订阅更新形成循环，先关 TUN 再更新订阅
- ✓确认客户端是否已启用代理。如果客户端在未连接状态下更新订阅，可能走的是直连链路，而直连链路恰好不通
特殊情况：部分网络环境会干扰特定域名的访问。如果你发现某个订阅域名总是拉不下来，可以尝试先在浏览器里访问该域名，确认它是否在当前网络下可达。
06修复面板三：格式不匹配
格式不匹配 · 转一次就能用
格式不匹配是最容易被误判的一类。因为它的表现不是“拉不下来”，而是拉下来了但用不了——节点列表是空的，或者客户端提示配置文件无效。很多人以为是链接坏了，实际上是格式不对。
- ✓先确认格式。把链接粘贴到浏览器地址栏，看返回的内容。如果是 Clash 系 YAML，应该能看到
proxies:、proxy-groups:这样的字段 - ✓如果是 base64 编码（一长串看不懂的字符），说明这是 V2Ray 系订阅格式，需要用订阅转换工具转成 Clash 格式
- ✓做一次订阅转换。把原链接粘进转换工具，选择输出格式为 Clash，拿到转换后的新链接再导入
- ✓自建转换服务更稳妥。公共转换服务有隐私风险和可用性风险，长期使用建议自建，具体方法见安装指南
需要留意：转换后的链接需要定期更新。如果你自己搭转换服务，记得给转换后的链接也配上定时更新，否则节点变了但转换结果还是旧的。
07四种预防措施：让失败少发生
上面的方法解决的是“已经失败了怎么办”。如果你还没遇到失败，下面四件事做了，能让失败概率明显降低。
01订阅链接单独备份一份
把订阅链接存在一个安全的地方（比如密码管理器），不要只存在客户端里。客户端出问题需要重装时，你还能快速恢复订阅。
02打开定时自动更新
大多数订阅失败发生在链接过期后的第一次手动更新。打开自动更新后，客户端会定期拉取，链接失效能被更早发现。
03记下订阅服务方的到期时间
链接过期的一个常见原因是服务到期。在日历里记下到期日，提前几天续费，避免到期那天突然发现拉不下来。
04准备一个备用订阅
主力订阅出问题时，有备用订阅能让你不至于完全断网。备用订阅不需要多贵，能应急就够了。
遇到订阅失败时，先不要立刻换链接。因为如果你换的是同一个服务方的链接，而问题出在网络或格式上，换了也白换。先按决策树判断类别，再决定动什么。
最后收个尾
订阅拉取失败的三种原因，在界面上长得一模一样，但处理方式完全不同。链接过期换链接，网络不可达换网络，格式不匹配做转换——用错方法，换十次链接也没用。
记住决策树的第一个问题就够了：“这个链接之前能用吗？”能，就往链接和网络方向查；不能，就往格式方向查。这一步答对，后面的路会短很多。