更新失败的报错,先分四类
点下「更新」按钮,转圈几秒,弹出一行红字。各客户端的报错文案不尽相同,归到底只有四类,指向四条完全不同的排查路径。先看清自己撞上的是哪一类,再动手。
| 报错形态 | 实际含义 | 优先怀疑 |
|---|---|---|
| 超时 / timeout / EOF | 请求根本没到达服务器 | 网络环境、域名被封锁 |
| 401 / 403 / Unauthorized | 链接里的令牌被服务器拒绝 | 套餐到期、流量耗尽、链接被重置 |
| 404 / Not Found | 订阅路径已经变更 | 链接过期,需重新复制 |
| 解析失败 / yaml error / format error | 拉回来的不是节点数据 | 订阅转换异常、返回了 HTML 错误页 |
一个常见误区:不管什么报错都先重装客户端。重装既不换链接也不换网络,上面四类问题一类都解决不了,只是浪费时间。
第一步:检查订阅链接本身
订阅链接是整个配置的源头,先花三十秒验证它。把链接完整粘贴到浏览器地址栏,回车,看返回内容:
- 一大片以
proxies:开头的 YAML 文本,或一长串无规律的 base64 字符:链接活着,问题出在客户端或网络,继续往下查。 - 403 提示、到期提醒、流量耗尽公告:账号侧被停用。登录机场官网确认套餐状态,续费或等流量重置后再更新。
- 跳转登录页、提示链接不存在:订阅令牌大概率被重置过。回官网重新复制最新链接,在客户端里编辑该配置,把旧地址整体替换掉。
健康订阅返回内容的开头长这样(以 YAML 格式为例):
proxies:
- name: "香港 01"
type: ss
server: hk01.example.com
port: 8388
cipher: aes-128-gcm
password: "your-password"还有两个细节值得顺手检查:
- 复制链接时首尾带出空格或换行,客户端会直接判定地址非法。粘贴后检查首尾字符,多余的一律删掉。
- 部分机场按 User-Agent 区分返回内容:浏览器能打开不代表客户端能拉到,反过来也成立。浏览器验证只用于确认「链接是否存在」,不能替代客户端实测。
第二步:排查网络环境,打破死循环
更新订阅本质是一次普通 HTTPS 请求。麻烦在于,不少机场的订阅域名本身已被封锁,而节点恰好全部过期——要更新得先有可用代理,要有可用代理得先更新成功。这是订阅排障里最典型的死循环。三条破循环的路:
用代理更新
手里只要还剩一个能连的节点,就能借力。Clash Verge Rev 里打开「配置」页,右键目标订阅选「编辑」,勾选「使用代理更新」(部分版本写作「通过代理更新」),保存后重新点更新,请求会经当前代理发出。
换网络更新
家庭宽带拉不动就切手机热点。移动网络与宽带对同一域名的封锁策略经常不同,很多「怎么都更新不了」换 4G/5G 一次就过。更新完切回原网络即可,不影响后续使用。
开 TUN 模式再更新
TUN 模式通过虚拟网卡接管全局流量,客户端自己发出的更新请求也会被纳入代理,等效于强制走代理更新。前提是内核运行正常、且仍有可用节点。
公司与校园网场景
单位网络常拦截未知域名、限制非常用端口。同一客户端在家正常、在单位失败,基本就是出口网络的问题,换网络验证最快,不必折腾客户端设置。
第三步:检查客户端与订阅转换
- 订阅转换多一层故障点。转换链接 = 原始订阅 + 转换后端 + 规则模板,任何一环挂掉都会更新失败。排障时先换回机场提供的原始链接试一次:能通,问题就在转换服务,换后端或干脆用回原始链接。
- 本地配置缓存损坏。症状是点更新没反应、或反复报解析错误。删除这份配置,重新粘贴链接新建,比重装客户端快得多。
- 客户端内核太旧。机场订阅如今普遍带 mihomo 专属协议字段(hysteria2、tuic、vless 等),原版 Clash 内核不认这些类型,表现为更新后节点大片缺失、或直接解析报错。换用 mihomo(Clash Meta)内核的客户端即可正常识别,各平台对应版本见下载页。
- 权限与目录问题(少见)。客户端装在只读目录、或配置目录被安全软件锁定,会导致拉取成功却写不进缓存。换到常规目录重装可解。
更新失败 ≠ 节点全挂
拉取失败时客户端会保留上一份旧配置,只要旧节点里还有能用的,代理就不中断。可以从容排查,不必急着换订阅。
设置自动更新间隔
手动点更新总会忘。主流客户端都支持按时间间隔自动拉取,设一次即可。
Clash Verge Rev
打开「配置」页,右键目标订阅 →「编辑」→ 找到「更新间隔」(单位:分钟),填入数值后保存。也可以在设置里配置全局默认间隔,之后新建的订阅会自动继承。
FlClash / Clash for Android
在配置列表长按目标订阅(或点右侧编辑入口)进入详情页,设置自动更新间隔后保存。
间隔建议设在 360 到 720 分钟之间。间隔太短,频繁请求可能触发机场侧限频,反而更新失败;间隔太长,节点增减、入口 IP 更换都跟不上。机场公告要求「缩短更新间隔」时,再临时调小。
注意一个前提:自动更新只是定时执行同一次拉取。如果失败根源是网络封锁,自动更新同样会失败。先按前两步把网络打通,间隔设置才有意义。
排查顺序速查
- 浏览器打开订阅链接,确认链接本身活着。
- 登录机场官网,确认套餐在有效期、流量未耗尽。
- 切手机热点更新一次,判断是否本地网络封锁。
- 勾选「使用代理更新」,或开启 TUN 模式后再更新。
- 去掉订阅转换,改用机场原始链接。
- 删除配置重建;仍失败则升级到 mihomo 内核客户端。
六步走完,九成能定位
按序走完这六步,九成以上的更新失败都能定位到具体环节。剩下的一成,多是机场在迁移服务器或更换订阅系统——看官网公告,或等几小时再试。