# 订阅更新失败的几种原因，看报错原文就能分开 > 来源 https://jichangtuijianweb.co/kepu/dingyue-gengxin-shibai/，更新于 2026 年 9 月 20 日。机场推荐网（https://jichangtuijianweb.co/）原创内容。 > 分类 排障。 订阅更新失败先看卡在哪一步。服务器没给内容，查账户、链接和网络；给了内容却解析不出节点，多半是格式和客户端没对上。两类报错的原文长得不一样，对着看就能分开。 点一下更新，客户端做的事分两步。先把[订阅地址](https://jichangtuijianweb.co/cidian/#subscription)当成一个网址去下载，再把下回来的文字解析成节点。两步都可能出错，报出来的话也不一样。 我把 [Clash Verge Rev](https://jichangtuijianweb.co/kehuduan/clash-verge-rev/) 2.5.2 和 [v2rayN](https://jichangtuijianweb.co/kehuduan/v2rayn/) 7.24.9 处理订阅的源码读了一遍，又对照了开源面板 Xboard 生成订阅的代码。本站收录的机场各用什么面板，我没有逐家核实，下文说到服务器那头怎么处理，都以 Xboard 为例。 ## 一次更新走哪条网络，两个客户端做法不同 Clash Verge Rev 的订阅卡片右键菜单里有更新和更新（代理）两项。点更新，它先直接连订阅服务器，失败了后台会自己换路重试，先借内核的代理，再借系统代理，三条路都不通才报错。换路成功的话，界面会提示使用 Clash 代理更新成功。单次请求默认等 20 秒，这个数在订阅的编辑信息里叫 HTTP 请求超时。更新失败时原来的配置原样保留，节点还能接着用。 v2rayN 不会自动换路，要自己选。订阅分组菜单里有四项，更新全部订阅和更新当前订阅各分不通过代理、通过代理两种。通过代理借的是 v2rayN 自己的 socks 端口，走不通会退回直连再试一次，每次请求最多等 15 秒。过程逐行打在主界面下方的信息栏里，顺利的话是这几行。 ``` 更新订阅开始 开始获取订阅内容 获取订阅内容成功 开始解析和处理订阅内容 更新订阅结束 ``` 停在哪一行，就是哪一步出了事。 两个客户端请求时都会在 User-Agent 里报上自己的名字和版本，Clash Verge Rev 写的是 `clash-verge/v2.5.2`，v2rayN 写的是 `v2rayN/7.24.9`。服务器靠这一行决定发哪种格式，后面好几个问题都和它有关。 ## 九种报错原文，各自卡在下载还是解析 | 看到的报错 | 客户端 | 卡在哪一步 | |---|---|---| | `failed to fetch remote profile with status 403 Forbidden` | Clash Verge Rev | 下载，服务器拒绝了 | | 信息栏里带 403 的英文报错，后面跟着无效的订阅内容 | v2rayN | 下载，服务器拒绝了 | | 状态码是 404 | 两个都会有 | 下载，地址不对 | | `failed to fetch remote profile`，后面没有状态码 | Clash Verge Rev | 下载，没连上服务器 | | `invalid peer certificate: UnknownIssuer` | Clash Verge Rev | 下载，证书不被信任 | | `the remote profile data is invalid yaml` | Clash Verge Rev | 解析，回来的不是 Clash 格式 | | ``profile does not contain `proxies` or `proxy-providers` `` | Clash Verge Rev | 解析，配置里没有节点 | | 获取订阅内容成功，紧跟着导入订阅内容失败 | v2rayN | 解析，内容认不出来 | | 订阅配置校验失败，变更已撤销 | Clash Verge Rev | 内核校验，有节点或字段内核不认 | 404 最简单，链接复制错了，或者复制成了面板网页的地址，回用户中心用复制按钮重新拿一次。下面按剩下几类分开讲。 ## 403 说明面板认出了请求，但不给节点 Xboard 返回 403 分两种情况。一种是链接里的 token 缺了或者对不上，响应正文分别写着 token is null 和 token is error，订阅被重置过的旧链接就落在这里。另一种是账户不可用，被封禁、已经到期、套餐额度为零，这时正文是空的。 所以看到 403，先登录用户中心看到期日，再确认手里的链接是不是最新的。自己或别人点过重置订阅，就重新复制一份，每台设备都要换。重置会同时换掉哪些东西，[订阅链接为什么不能外传](https://jichangtuijianweb.co/kepu/dingyue-lianjie-anquan/)里对着源码讲过。 流量用完反而不会走到 403。Xboard 判断账户能不能拿订阅时，只看封禁、到期和额度，不看已经用掉多少，所以流量见底以后订阅照样能更新成功。节点服务器那边的判断更严，只放行已用量小于额度的账户，结果就是更新一切正常、节点全部超时。碰到这种情况，按[连不上的排查顺序](https://jichangtuijianweb.co/kepu/lianbushang-paicha/)看一眼订阅卡片就明白了，流量怎么算的见[流量倍率和重置日](https://jichangtuijianweb.co/kepu/liuliang-beilv-chongzhi/)。 Clash Verge Rev 的常见问题里另有一条导入订阅报错 401，官方的办法是删掉配置目录里的所有文件再重启。这一步会清掉本地全部订阅和设置，设置页配置目录那一项的说明也要求先备份。同一条链接换个客户端能正常更新，才说明毛病在本地，这时再动手。 ## 报错里没有状态码，请求没到服务器 没有状态码，意思是请求连服务器都没见着。订阅地址在当前网络下打不开就是这样。用 Clash Verge Rev 的话，它已经替你试过内核代理和系统代理，三条路都失败，说明手上也没有能用的节点。 先换网络。手机从 Wi-Fi 换到流量再更新，电脑连手机热点也行。 换了网络还不行，就找一台能打开订阅地址的设备把内容取下来，存成文件带回来导入。这里有个坑，用浏览器直接打开订阅地址，浏览器的 UA 不在 Xboard 认识的名单里，拿到的是分享链接格式。要给 Clash Verge Rev 用，得用文末那条 curl 命令带上它的 UA 去取。文件拿到以后，在订阅页点新建，类型选 Local，再选这个文件，官方文档写明 1.6.2 以后也能把文件直接拖进订阅页。v2rayN 认的是分享链接，把内容复制下来，在配置项菜单里点从剪贴板导入分享链接。这样导进来的内容不会自己更新，网络恢复以后换回订阅地址。 自己写配置、用 proxy-providers 引入节点的，mihomo 文档里给 proxy-providers 留了一个 `proxy` 字段，填上配置里已有的代理组名，更新节点时就经过这个代理去下载。 ```yaml proxy-providers: jichang: type: http url: "https://你的订阅地址" interval: 86400 proxy: 节点选择 ``` `UnknownIssuer` 这个报错单独说。它的意思是订阅服务器出示的证书，签发者不被信任。Clash Verge Rev 文档给的办法是在编辑信息里勾选允许无效证书（危险），勾上以后客户端不再核对证书，中间有人换掉内容也看不出来。我会先查两样东西。一是系统时间，证书有效期按时间判断，钟差太远会校验失败。二是杀毒软件的 HTTPS 扫描和公司网络的上网审计，它们会在中间解密再用自己的证书重新加密，签发者自然对不上。 ## 内容下来了，却解析不出节点 这一步服务器已经回了 200，问题出在回来的东西和客户端要的对不上。 Xboard 决定发什么格式，先看链接里有没有 `flag` 参数，没有就看 User-Agent。UA 里带 verge、flclash、meta、clashmetaforandroid 或 nekobox 的，拿到 Clash Meta 的 YAML。带 v2rayn、v2rayng、passwall、ssrplus 或 sagernet 的，拿到分享链接。一个都不沾的，也按分享链接发。 从这张名单能推出两种失败。在 Clash Verge Rev 的编辑信息里改过 User Agent，填了个名单外的名字，回来的就是分享链接，客户端报 invalid yaml。清空那一栏，它会恢复默认的 `clash-verge/v2.5.2`。反过来，用 v2rayN 导入了带 `flag=clash` 一类参数的链接，拿到的是 YAML。v2rayN 7.24.9 不会为此报错，它把整份 Clash 配置当成一条自定义配置导进来交给 mihomo 内核跑，列表里只多出一行。想要一个个节点，回用户中心换通用订阅或标着 v2rayN 的那条。 还有一种是服务器回了一个网页。登录页、拦截页、要人点一下验证的页面都是 HTML。Clash Verge Rev 碰到它报 invalid yaml，v2rayN 7.24.9 会识别出这是网页，报导入订阅内容失败。 v2rayN 在这里有个细节。它在解析新内容之前，先把这条订阅下的旧节点删了，新内容解析不出来，列表就空了。下载失败时不会走到这一步，旧节点还在。Clash Verge Rev 在任何一步失败时都保留旧配置。所以同样是更新出错，v2rayN 用户可能会看到一个空列表，这不代表账户出了事。 有人会想用订阅转换把格式凑上。v2rayN 的订阅分组设置里有一栏订阅转换目标类型，填了它，v2rayN 会把你的订阅地址交给一个转换服务，没在设置里改过订阅转换网址的话，用的是内置列表里第一个公共服务 `sub.xeton.dev`。订阅地址就是账户凭据，交出去之前想清楚。 ## 更新成功了，节点却少了一批 Xboard 会按客户端再筛一遍节点。每种输出格式有一张能装的协议清单，装不下的节点直接去掉。版本也要查，代码里写着给 v2rayN 的 Hysteria2 节点要求版本不低于 6.31，给 v2rayNG 的要求不低于 1.9.5，版本号取自 User-Agent。客户端太旧，或者 UA 里的版本号被改成了旧的，某一类节点就会整批消失。升级客户端，或者把自定义的 UA 清掉。 Clash Verge Rev 这边还有一道关。下载和解析都过了，内核还要把整份配置校验一遍，某个节点的协议或参数内核不认，就提示订阅配置校验失败，变更已撤销，后面附着错误详情。这时要升级的是客户端和它带的内核，订阅本身没问题。 ## 自己请求一次，看服务器回了什么 想绕开客户端看服务器的原始回应，就自己发一次请求，User-Agent 照着客户端的写法填。Windows 里写 `curl.exe`，macOS 和 Linux 写 `curl`。 ``` curl.exe -s -D - -o sub.txt -A "clash-verge/v2.5.2" "https://你的订阅地址" ``` `-D -` 把响应头打在屏幕上，`-o sub.txt` 把正文存进文件。先看第一行的状态码，200 以外的对照上面的表。再找 `subscription-userinfo` 这一行，Xboard 给 Clash 格式的回应里会带上它，upload 和 download 是已用的上传下载量，total 是总额度，expire 是到期时间的时间戳，Clash Verge Rev 订阅卡片上的流量和到期日就是从这里读的。 然后打开 sub.txt 看开头。有 `proxies:` 的是 Clash 的 YAML。一整段看不出意思的字母和数字，多半是 Base64 编码的分享链接。以 `