订阅更新失败：沿着下载、解析、启用三步定位
把订阅故障拆成三个可验证的环节，保留可用配置，辨别链接、响应格式与启用状态的问题。
先保住可以工作的那份配置
假设你昨天能连接，今天更新后节点列表变空。此时最有价值的线索是“更新前仍能工作”，而不是节点数量。不要先删除客户端、清空配置或重置系统网络。先复制当前配置的名称、更新时间和节点数量；如果软件支持导出，保留一份离线副本。导出的订阅或节点资料也包含个人凭据，只放在自己的设备上。
本教程用“家庭 Wi-Fi、同一设备、同一配置”作为固定条件。记录错误的原文和时间，例如“下载超时”“无法解析”或“没有可用代理组”。这三类现象落在不同阶段，逐项验证比反复点击更新更有帮助。
- 暂停自动更新或先切换到已验证的本地配置。
- 记下客户端与内核版本、当前网络、失败时间和错误文本。
- 保留旧配置，新增一个测试副本；后续操作只在副本中进行。
下载入口是否真的是订阅
服务商账户页、套餐页和订阅入口可能来自同一个域名，却返回完全不同的内容。浏览器能打开一个网址，只能说明某种页面可访问，不能说明客户端拿到了配置。确认你从账户中的订阅功能复制了完整地址，没有把末尾的凭据漏掉，也没有粘贴前后的空格。
不要把订阅发到陌生在线转换站“试试看”。若链接已公开泄露，先在服务商后台更换凭据，再更新本地记录。测试时隐藏查询参数，向客服提供时间与错误码即可。
- 在服务商账户核对订阅有效期和剩余流量。
- 重新复制适用于该客户端的订阅入口，检查地址首尾。
- 若提示 401 或 403，核对授权与访问限制；若提示 404，重新核对入口。错误码只是线索，以服务商答复为准。
失败发生在网络路径，还是内容解析
下载超时与格式错误应分开处理。超时可能来自当前网络到订阅服务器的路径；格式错误则意味着程序获得了内容，但无法按预期读懂。不能从一次超时推断所有节点失效。也不要因网页可访问，就把客户端错误当成软件故障。
做一个小范围对照：同一测试副本，在 Wi-Fi 和手机热点各更新一次，除此以外保持设置相同。只在某个网络失败，优先记录网络差异；两个网络都提示同一解析错误，优先检查订阅类型和返回内容。避免在短时间连续请求，以免触发服务器限制。
- 在原网络更新一次，保存完整错误。
- 换到一个可信的备用网络，再更新同一副本。
- 核对返回的是配置内容还是登录页、验证码页、错误提示页。不要把完整响应公开分享。
配置格式要跟客户端能力对上
Clash/mihomo 配置、sing-box JSON、节点分享链接并不是可以随意互换的文件。一个客户端支持某个节点协议，也不代表它能完整读取另一个客户端的路由规则。优先使用服务商提供的适配入口。sing-box 原生配置还需与内核版本匹配；旧字段报错时应查对应版本的迁移说明，而不是只把文件扩展名改成 JSON。
如果你的 GUI 支持订阅转换，确认它是哪个功能、转换发生在哪里、是否保留代理组和规则。转换后先在独立副本里验证。对于不认识的字段，保留日志中的字段名与版本信息，不必把全部配置贴到论坛。
- 记录订阅类型及所选导入方式，例如远程配置或节点订阅。
- 检查客户端官方文档与服务商的适配说明。
- 确认节点列表、代理组、默认路由都出现，再把配置设为活动配置。
更新成功，为什么还是使用旧节点
“更新成功”只证明下载或导入动作结束，并不一定说明活动配置已更换。有的软件同时保存多份配置；有的代理组仍记住原来的节点；还有的请求连接已经建立，会继续使用旧连接。先看当前活动配置名称，再看实际选中的代理组和节点。
验证时关闭测试网页后重新打开，观察新请求进入哪个节点。不要以所有历史连接立即迁移作为成功标准。若只是某个节点失效，在同一代理组换一个已知可用节点即可，不需要删除整个订阅。
- 确认当前启用的配置就是刚更新的副本。
- 在代理组中选择一个可用节点，创建一个新的网页请求。
- 查看连接记录：目标域名、匹配规则和出站是否与预期一致。
恢复与下一次维护
若副本始终失败，切回更新前保留的配置，先恢复基本连接，再处理问题。不要用删除旧稿作为排障手段。向软件维护者或服务商反馈时，用最小信息描述：客户端版本、订阅格式、错误环节、网络对照结果，以及已隐藏个人信息的日志片段。
确认新的配置至少经历一次启动、一次更新、一次真实请求，再移除测试副本。记录更新时间与变更，未来出现问题可以判断是服务商返回内容变化、客户端升级，还是本地配置改变。
- 恢复已验证的配置，检查浏览器能否正常连接。
- 记录本次失败原因与可复现步骤。
- 完成验证后再清理测试副本，并检查自动更新策略。
官方资料
功能与配置说明以官方资料为准。