订阅导入失败排查:更新超时、节点为空与格式错误
订阅更新失败、导入后节点列表为空或提示格式错误时,按从省事到费事的顺序逐项检查:订阅地址、套餐状态、网络可达性、更新方式、订阅格式、客户端版本与系统时间,并给出对应的解决办法。
SYMPTOM问题表现
- 更新订阅时提示失败、超时或连接错误
- 提示导入成功,但节点列表是空的
- 提示无效的订阅内容、配置格式错误或解析失败
- 以前能正常更新的订阅,某一天开始一直更新失败
适用范围
- v2rayN
- v2rayNG
- Clash Verge Rev
- Shadowrocket
目录13 节
订阅导入失败看起来只有一句「更新失败」,背后却可能是三类完全不同的问题:地址本身不对,客户端访问不到这个地址,或者下载到的内容客户端读不懂。下面的检查顺序按「最省事的先做」排列,多数情况在前三步就能定位。
问题表现
- 点击更新订阅后,客户端提示失败、超时或连接错误,节点列表没有变化。
- 客户端提示更新完成,但节点列表为空,或者只有寥寥一两行名称像提示语的条目。
- 客户端提示「无效的订阅内容」「解析失败」「仅支持 YAML 文件」之类与格式有关的错误。
- 订阅之前一直正常,从某一天开始更新失败,已有的节点也陆续连不上。
可能原因
| 类别 | 具体原因 |
|---|---|
| 地址不对 | 复制不完整,或首尾混入了空格、换行 |
| 地址不对 | 在面板里重置过订阅,旧地址已经作废 |
| 账户状态 | 套餐已到期,或当期流量已用尽 |
| 访问不到 | 订阅域名在当前网络下无法访问,需要通过代理更新 |
| 访问不到 | 订阅域名只能直连访问,而客户端正在通过一个失效的节点更新 |
| 访问不到 | 安全软件、公司或校园网络拦截了请求 |
| 访问不到 | 系统时间不准,HTTPS 证书校验失败 |
| 读不懂 | 订阅格式与客户端不匹配(Clash YAML、通用 Base64、sing-box JSON) |
| 读不懂 | 客户端或内核版本过旧,不认识订阅里新协议的节点 |
检查顺序
按编号依次做,每一步有了明确结论再进行下一步。
- 重新复制订阅地址。 登录服务商面板,用「复制」按钮重新复制一次,替换客户端里原有的地址。
- 确认套餐状态。 在面板里查看到期时间和剩余流量。
- 在浏览器里直接打开订阅地址。 看返回的是什么内容,判断方法见下表。
- 换一个网络再更新。 例如把电脑连到手机热点。
- 切换更新方式。 原来通过代理更新的,改成不通过代理;原来直连更新的,改成通过代理。
- 核对订阅类型与客户端是否匹配。
- 把客户端更新到最新的正式版本。
- 核对系统的日期、时间和时区。
第 3 步的结果可以这样解读:
| 浏览器里看到的 | 说明 | 下一步 |
|---|---|---|
| 一长串没有空格的字母和数字 | 通用订阅(Base64 编码),地址有效 | 检查第 6 步 |
含有 proxies:、proxy-groups: 等字样的多行文本 |
Clash 格式的配置,地址有效 | 检查第 6 步 |
以 { 开头、含有 outbounds 字样的文本 |
sing-box 格式的配置,地址有效 | 检查第 6 步 |
| 内容很短,或只有一两条提示性文字 | 多半是套餐到期、流量用尽或地址已失效 | 回到第 1、2 步 |
| 报错页面(例如 403、404) | 地址失效,或请求被服务端拒绝 | 回到第 1 步 |
| 页面打不开或一直转圈 | 当前网络访问不到订阅域名 | 做第 4、5 步 |
说明
不少订阅服务会根据请求里的 User-Agent 返回不同格式的内容。浏览器里看到的是 Base64,不代表 Clash 客户端拿到的也是 Base64。所以这一步主要用来判断「地址是否有效、能否访问」,格式问题还要结合第 6 步。
解决步骤
地址复制不完整或已失效
删除客户端里原有的订阅条目,从面板重新复制后再添加一次。粘贴后检查三点:地址以 https:// 开头;末尾的参数(形如 ?token=xxxx)完整;首尾没有空格或换行。
遇到以 http:// 开头的订阅地址,v2rayN 和 v2rayNG 会提示不要使用不安全的 HTTP 协议订阅地址。正常的订阅地址应当是 HTTPS 的,看到这条提示时先核对地址有没有复制错。
如果你曾在面板里点过「重置订阅」,之前保存在各个设备上的旧地址会全部作废,每台设备都需要换成新地址。
套餐到期或流量用尽
续费或等待流量重置后,再更新一次订阅即可恢复。不确定剩余流量是否够用到周期结束,可以用 套餐计算器 估算一下。
当前网络访问不到订阅域名
这种情况有两个相反的方向,需要都试一遍:
- 订阅域名在本地网络下无法直接访问。 如果客户端里还有能用的旧节点,先连上,再选择「通过代理更新」。如果一个可用节点都没有,换一个网络(例如手机热点)直连更新,或者联系服务商获取备用的订阅地址。
- 客户端正通过一个已失效的节点去更新。 这时每次更新都会超时。改成不通过代理更新,或者先关闭代理再更新。
各客户端里对应的操作:
| 客户端 | 切换更新方式的位置 |
|---|---|
| v2rayN | 「订阅分组」菜单里分别有「不通过代理」和「通过代理」两组更新选项 |
| v2rayNG | 分别在已连接和未连接两种状态下各更新一次 |
| Clash Verge Rev | 在订阅卡片上点右键,有「更新」和「更新(代理)」;「编辑信息」里可以设置更新时是否使用系统代理或内核代理 |
| Shadowrocket | 分别在连接开关打开和关闭两种状态下各更新一次 |
不同版本的界面文字可能略有差异,以实际界面为准。
订阅格式与客户端不匹配
先弄清服务商提供的是哪种订阅,再对照客户端:
| 订阅类型 | 匹配的客户端 |
|---|---|
| Clash / Mihomo 订阅(YAML) | Clash Verge Rev 等使用 mihomo 内核的客户端 |
| 通用订阅(Base64 编码的节点链接列表) | v2rayN、v2rayNG、Shadowrocket |
| sing-box 订阅(JSON) | sing-box 客户端 |
多数面板会为不同的客户端分别提供订阅地址或「一键导入」按钮,选与你的客户端对应的那一个。三种格式的区别见 Clash 与 Mihomo 基础知识。
不建议把订阅地址粘贴到来历不明的在线「订阅转换」网站来解决格式问题。这等于把你的订阅凭证交给了第三方。
客户端版本过旧
订阅里出现了客户端内核不认识的协议时,旧版本可能直接报解析错误,也可能悄悄丢掉这些节点,结果是列表为空或节点数量明显偏少。从官方仓库或官方应用商店把客户端更新到最新的正式版本,再重新更新订阅。已经停止维护的客户端没有新版本可升,只能换用仍在维护的客户端。
系统时间不准
客户端通过 HTTPS 下载订阅,需要校验服务器证书的有效期。系统时间偏差过大时,证书会被判定为无效,更新随之失败。打开系统的日期与时间设置,开启自动设置时间并同步一次,同时确认时区正确。
安全软件或受管理的网络拦截
公司、学校的网络以及部分安全软件会拦截这类请求,或者替换 HTTPS 证书,客户端因此报出证书错误。换用手机热点可以快速验证是不是这个原因。Clash Verge Rev 的订阅设置里有「允许无效证书(危险)」的选项,它会跳过证书校验,只适合临时判断问题所在,不应长期开启。
验证方法
- 节点列表出现。 列表里的节点数量与服务商面板或公告中的大致相符,节点名称正常。
- 延迟测试能得到数值。 对全部节点做一次真连接延迟测试,至少有一部分节点显示出以毫秒为单位的数字。
- 实际访问成功。 选定一个节点并开启代理,打开一个需要代理才能访问的网站。
第 1 步通过而第 2 步全部超时,说明问题已经不在订阅上,而在节点连接上,请转到 节点显示已连接却打不开网页 继续排查。
补充说明
订阅地址等同于账号密码。 地址里的 token 就是你的身份凭证,拿到它的人可以直接消耗你的套餐流量。不要把完整地址截图外传,也不要贴到群聊或论坛里。一旦怀疑泄露,立刻在面板中重置订阅,然后给每台设备换上新地址。服务商一侧能看到哪些信息,见 使用机场时的隐私边界。
联系客服时提供这些信息,能明显缩短来回沟通的时间:
- 客户端的名称与版本号,以及所用的操作系统;
- 报错信息的原文,直接复制文字,或者截图并遮住订阅地址;
- 问题出现的时间,以及当时使用的网络类型(家庭宽带、移动数据、公司网络);
- 已经做过的检查,例如「在浏览器里能打开订阅地址」「换手机热点后仍然失败」。
不要把完整的订阅地址发到群里;确实需要提供时,只通过工单或私信发给官方客服。
重新走一遍导入流程。 如果排查之后决定从头再来,可以对照 v2rayN 基础教程 或 Clash Verge Rev 基础教程 里的步骤,逐步核对每一步「应该看到什么」。