F · 订阅问题

订阅更新失败：节点列表为空或提示解析失败的处理方法

订阅更新失败通常不是客户端坏了，而是链接不完整、格式不匹配、订阅域名无法直连或套餐已到期。本文给出适用于 v2rayN、Clash Verge Rev 与 sing-box 的通用排查顺序。

问题描述

在客户端添加订阅后点击更新，节点列表没有出现，或客户端提示下载失败、解析失败。

CHK-01

浏览器直接打开订阅链接

正常情况下会下载一个文件，或显示一长串 Base64 文本 / YAML 配置。
CHK-02

查看返回内容的格式

包含 proxies 与 proxy-groups 字段的是 Clash YAML；一长串字母数字通常是 Base64 编码的链接列表。
CHK-03

核对用户中心状态

确认套餐有效、未超出设备数，并查看是否有“重置订阅”记录。

01

重新复制订阅链接

在用户中心使用“复制订阅”按钮而不是手动选择文本，粘贴后检查首尾没有空格。
02

换用正确格式的订阅

Clash Verge Rev 使用 Clash 订阅；v2rayN 使用 V2Ray / 通用订阅；sing-box 使用 sing-box 配置链接。
03

通过代理更新

如果还有任何一个可用节点（例如上一次更新留下的），v2rayN 中选择“更新全部订阅（通过代理）”，Clash Verge Rev 在订阅的“编辑信息”中开启通过 Clash 代理更新的选项（名称以当前版本界面为准）。
04

联系服务商重置

以上都无效时，在用户中心重置订阅并重新导入；注意重置后其它设备也需要更新链接。

订阅链接是服务商为你的账户生成的一个下载地址，客户端定期访问它获取最新的节点信息。它相当于账户凭证：不要把订阅链接发到公开群组或交给在线转换网站，泄露后他人可以直接使用你的流量。

客户端的报错信息往往很笼统，而浏览器测试可以把问题一分为二：链接这一端是否正常、客户端这一端是否正常。只要浏览器能拿到内容，后续就只需要关注格式和客户端设置。