故障排查 4 分钟阅读
订阅更新失败怎么办？Clash、Mihomo 常见错误完整排查
订阅更新失败要先分清地址错误、Timeout、403、5xx 和 DNS 解析异常。
排障原则：每次只改变一个变量，记录改变前后的结果，比同时修改十个参数更容易找到根因。
先判断问题范围
订阅更新失败要先分清地址错误、Timeout、403、5xx 和 DNS 解析异常。
排障时先确认问题是“单个节点/单个应用”还是“全部节点/全部应用”。范围不同，优先级完全不同。
为什么会出现这种情况
订阅本质上是客户端下载远端配置。链接缺字符、token 失效、网络无法访问、服务器拒绝或上游故障都会失败。
网络问题经常跨越本地网络、DNS、代理核心、规则和目标网站多个层级，所以只看一个延迟数字或一个按钮状态通常不够。
推荐按这个顺序处理
重新复制完整订阅；浏览器直接测试链接；切换网络；区分 403/502/超时；删除旧订阅后重新导入。
每完成一步都保留结果。如果某一步改变后立即恢复，就先在这一层深入，不要继续无目的修改其他配置。
最容易踩的坑
不要连续高频刷新，也不要公开完整订阅链接或 token。
需要分享日志或截图时，记得遮住订阅 token、UUID、密码、API Key 等敏感信息。
怎么判断已经定位到原因
403 表示服务器明确拒绝；502 更偏向网关上游异常；Timeout 是规定时间内未完成连接。
一个可靠结论应该可以重复：在条件 A 下稳定失败，改变单一变量到条件 B 后稳定恢复，再切回 A 又复现。
常见问题
为什么不建议一上来重装客户端？
重装会同时改变配置、缓存、服务和权限，虽然有时能恢复，但不利于知道真正根因，也可能丢失原有设置。
什么时候应该联系服务商？
多个设备、多个网络都稳定复现同一错误，且已经记录时间、状态码和日志时，服务端排查最有效。
说明：不同客户端版本的按钮名称和参数可能变化。涉及公司、校园或公共网络时，请遵守对应网络管理规则；修改前建议备份原配置。
继续排查
先看更多教程，再决定是否需要更换服务或配置
如果你已经完成本文排查，也可以查看本站当前产品服务与其他教程。