订阅更新失败怎么排查？先分清链接、网络与版本

先判断失败发生在哪一步

“订阅更新失败”和“节点无法连接”不是同一个问题。更新失败表示客户端没能取得或接受新的配置；节点超时则可能是在配置已经载入后，连接具体节点时发生。旧配置仍能使用时，先保留它，不要删除全部订阅或立即重装。

记下客户端版本、系统版本、错误出现时间，以及是首次导入失败、已有订阅更新失败，还是更新后无法启用。把提示文字复制下来；截图时隐藏订阅地址和个人凭据。

第一步：重新核对订阅地址

1. 登录服务商后台，检查账户是否有效、套餐是否到期或流量是否用尽。
2. 从后台重新复制 Clash、Clash Meta 或 Mihomo 格式链接，确认不是首页、付款页或单个节点的分享地址。
3. 比较是否曾重置订阅。重置后旧地址可能失效，客户端中的 URL 需要同步更换。
4. 到「订阅」找到目标卡片，在编辑入口检查 URL，替换后保存，再更新一次。
5. 保留错误提示并观察结果，不要连续刷新相同地址。

复制的链接若有尾部空格、换行或漏掉参数，先修正这些问题。更新成功但节点仍旧时，再确认当前选中的卡片是不是刚更新的那一张。

第二步：按影响范围比较

比较时一次只改一项。例如在允许使用的其他网络上重试同一个订阅，其他设置保持不变；若结果不同，再检查原网络到订阅域名的路径。不要同时换网络、重置链接和重装软件，否则即使恢复，也不知道是哪项起作用。

第三步：根据具体错误继续检查

连接超时或 client error(Connect)

先确认当前网络本身正常。若旧节点仍能用，记录系统代理和 TUN 的开关状态，再尝试一次更新；无法判断请求是否经代理时，查看对应时间的日志，不要只看浏览器能否打开服务商首页。

订阅页的直接导入失败时，也可以使用新建远程配置的方式，见订阅导入教程 。另一种入口仍报相同错误，就继续检查网络和服务端，不必重复创建十几张相同卡片。

HTTP 401、403、404 或 429

401、403 可先检查权限、凭据与服务端限制；404 可先检查地址是否过期或路径错误；429 应停止连续请求，按服务端要求等待。状态码只是检查方向，不能单靠一个数字断定服务商停运。

如果后台正常而订阅仍返回错误，将发生时间和状态码发给服务商核对。不要在公开论坛贴出完整订阅 URL。

证书或 TLS 错误

检查电脑日期时间，再确认系统和客户端是否过旧。换一条可信网络比较是否存在网络拦截或登录认证。需要登录的公共 Wi-Fi，应先完成它正常的网络登录。保持证书校验，不要用允许无效证书来掩盖不明的连接异常。

YAML、配置解析或格式错误

订阅接口可能返回登录页、公告页或错误页面，而不是可用配置。浏览器能打开一个页面，不代表客户端收到的是同样内容；服务商也可能根据客户端类型返回不同格式。重新选择正确的订阅格式，有必要时请服务商检查返回内容，不要将个人订阅交给陌生转换站。

更新成功，却无法使用

1. 回到「订阅」，选中刚更新的配置。
2. 打开「代理」，检查节点和分组是否正常出现。
3. 原来的节点被改名或删除时重新选择，不要只保留失效的旧选项。
4. 确认规则模式和系统代理或 TUN 的状态。
5. 重新发起实际连接，区分是全部节点失败，还是某个目标网站失败。

如果启用配置时才出现错误，应保留配置检查提示，这与下载请求失败需要不同的排查材料。先恢复仍能启用的旧配置，避免一边断网一边进行大范围修改。

仍未恢复时怎样继续

按日志教程 重新记录一次失败，整理客户端及系统版本、错误时间、影响范围和已比较的条件。升级后才出现的问题，可到常见问题 查找相同系统和现象。仅标题相似还不足以认定是同一故障，提交反馈时提供自己的完整复现过程，比反复重装更有助于定位。