点了“更新订阅”，客户端弹出一条错误；再点一次，还是同样的结果。先别删掉原来的配置。订阅更新是在下载一份配置，节点连接是在使用配置里的线路，这两件事可以分别出问题。 更新失败时，原先已保存的节点可能仍能用；更新成功，也不保证每条免费节点都能连接。
下面以 Clash Verge Rev 为例，从报错出现的位置开始排查。还没完成过第一次导入，可以先看Windows 订阅导入步骤，其他设备从新手指引进入对应教程。
01 先看失败发生在哪一步
先记下报错的完整文字和刚才做的操作：是在粘贴链接后导入失败、在卡片上更新失败，还是选中配置时失败？只记“不能用”，很容易把不同问题混在一起。
看地址、连接和 HTTP 错误
看格式、字段和配置错误
看选中配置、出口与目标
例如，404 是请求的资源没有找到；yaml、parse 一类提示则可能发生在读取内容时。出现解析错误不一定是你写错了 YAML，也可能是客户端拿到了一整页网页。错误提示是定位线索，不是最终诊断。
如果已经能看到节点、更新也没有报错，只是访问很慢或超时，直接转到节点测速与选节点指南，不必继续折腾订阅下载。
02 确认复制的是订阅，不是介绍它的网页
回到本站免费订阅区，使用标注为 Clash / Mihomo 的复制入口。完整复制后重新粘贴一次，检查首尾是否混进了空格、换行、引号或聊天软件附带的句号。
这里有三种容易混淆的地址：
- 免费节点文章的网页地址： 打开文章，再复制里面的订阅地址；网页本身不是配置。
- 标明 Clash / Mihomo 的订阅地址： 粘贴到客户端的远程订阅导入入口。
- 单节点分享链接或另一种客户端专用订阅： 例如
vmess://、vless://，应使用相应的导入方式，不要默认它能作为完整 Clash 配置导入。
不能只凭地址有没有 .yaml 判断格式。 有些订阅由接口即时生成，网址没有文件后缀；反过来，即使网址以 .yaml 结尾，失效后也可能返回错误页面。要看实际返回内容和来源提供的格式说明。
对于按日期分享的免费资源，重新获取当前页面提供的地址，比在旧地址里手动改日期更可靠。不要删掉网址中看似多余的参数，也不要把几段不同链接拼在一起。
03 超时、403、证书错误，分别处理
下载阶段还没完成，就先围绕“从哪里下载、通过什么路径下载”检查。浏览器能打开网站首页，只说明首页可访问，并不能证明订阅接口返回了正确内容。
连接失败或超时。 timeout、Connect 只说明请求未正常完成，不能单凭这几个词确定原因。先确认普通联网正常、订阅域名没有写错，再对比下面介绍的下载路径。
401 / 403：认证未通过或请求被拒绝。 重新获取来源提供的完整地址。公共链接也可能遇到访问限制，不能看到这两个状态就断定账号到期。
404 / 410：资源未找到或已撤下。 回来源页寻找当前入口，停止反复刷新旧地址。
429：请求过于频繁。 停止连续点击，按服务提示等待后再试。
5xx：服务端或其网关出现错误。 稍后再试，并查看来源是否提供可用的替代入口。
证书或 TLS 错误。 看到 certificate 等字样，先检查电脑日期、时间、域名和网络登录状态，再看具体的校验或握手错误。
HTTP 状态码表示服务对这次请求的回应，不是节点质量评分。这些状态码的含义可对照 MDN HTTP 响应状态码。
浏览器能下载，为什么客户端不行？
浏览器可能用了代理扩展、系统代理或已有登录状态；客户端的订阅下载请求不一定沿同一条路径。比较时要看同一个完整地址，以及返回的是配置文本、文件，还是网页提示。不要把“浏览器页面打开了”直接当作配置可用。
在 Clash Verge Rev 的订阅卡片菜单里，可以找到“更新”和“更新（代理）”等入口。后者用于通过代理下载订阅；具体取用系统代理还是客户端代理，还与订阅设置有关。需要代理才能取回订阅、且你已有可用连接时，再用它做一次对比。如果当前代理本身已经失效，勾上代理更新不会凭空恢复网络。 菜单及下载选项见项目的订阅卡片实现。
这里调整的是订阅下载方式，不等于把日常网页切换为全局模式。也不要把“允许无效证书”当成通用修复按钮：它会绕过证书检查，却不能修复地址错误、服务端故障或失效节点。
04 提示格式错误，先看收到的是什么
如果能取回内容，却出现 YAML、parse、字段类型或配置校验错误，先查看内容开头和报错位置。
如果开头出现 <!DOCTYPE html>、<html>，或明显的网页登录提示，先回到地址和下载问题。不要删除几行网页标签，试图凑成一份配置。
如果确实是 YAML，再看错误是否指出某个行号、字段或不存在的代理组。保留原文件，先检查该处和相邻几行。 缩进、列表结构、引号以及复制时丢失的内容都可能影响解析；不要为了消除报错，把不认识的字段逐项删掉。
还要分清完整配置和代理集合。Mihomo 的 proxy-providers 可以读取 YAML、URI 或 Base64 形式的节点集合，但这不表示每一种集合都能直接作为客户端订阅页里的完整配置使用。完整配置还需要相应的组、规则及引用关系；单独看到 proxies: 不能证明整套配置已经齐全。Mihomo 代理集合内容说明
对本站分享，优先重新选择适用的 Clash / Mihomo 入口。如果报错明确涉及当前内核不认识的协议或字段，再检查客户端版本及来源要求；需要更新客户端时，从客户端下载页选择适合系统和架构的安装包，并先备份现有配置。
05 更新成功，节点却没变化？
先确认更新的是哪张卡片，正在使用的又是哪张卡片。有多个订阅时，只刷新了其中一份，却继续使用另一份，代理页面当然可能没有变化。
按顺序看这三件事：
- 目标配置是否已选中并成功加载。 留意切换或重新激活时有没有新的错误。卡片存在，不等于它已经成为正在运行的配置。
- 当前列表有没有筛选。 清除搜索条件，检查展开的代理组；不要把某个分组只显示几项误认为整份订阅只剩几条。
- 这份配置是否还有外部集合。 使用
proxy-providers的配置，主文件和外部节点集合是不同资源。主文件下载成功，不能证明每个集合也已经更新成功。日志若点名某个集合，就检查该集合的下载地址、更新结果及所用代理，而不是只刷新主订阅。代理集合的更新设置
若更新后才出现配置错误，而你使用了自定义规则、覆写或脚本，可以先保存这些内容，再逐项停用自己添加的部分做对比。比如原来的代理组被订阅改了名字，自定义规则却仍引用旧名称，就需要修正引用。每次只改一处，并记录结果。
更新成功但节点数量不变，也可能只是来源这次没有调整清单。不要用“数量必须增加”判断成功；应该结合更新结果、实际内容及节点可用性来看。
06 保留能用的，再修有问题的
原配置还能连接时，先保留它。要试新的订阅，可以另建一张名称清楚的卡片，确认导入、选中和实际访问都成功，再整理旧配置。这样下载失败时仍有退路。
如果来源提供了可以下载的完整配置文件，也可以尝试本地文件导入，帮助区分“客户端取文件失败”和“文件本身无法使用”。Clash Verge Rev 支持新建本地配置和拖拽文件；导入时会复制一份文件到配置目录。本地文件是这次取得的副本，不会自动跟着远程订阅更新。 官方订阅导入说明
仍然失败时，保留客户端版本、发生时间、具体操作以及同一时刻的错误日志。GUI 日志和内核日志用途不同：订阅下载失败优先找对应的应用日志，加载配置或连接失败再结合内核日志。需要详细记录时，按官方日志导出方法复现一次错误，排查后把日志级别恢复即可。
最后用一个实际操作收尾：选中修复后的配置，选择可用节点，重新打开原先要访问的网页。订阅能下载、配置能加载、实际访问能完成，这三个结果都明确了，才算这次问题解决。