导入失败和更新失败的区别
- 导入失败：第一次把订阅链接粘进客户端就报错。多半是链接或格式问题。
- 更新失败：之前能用，点“更新订阅”后报错或节点没变化。多半是机场换域名、订阅过期，或者更新请求本身被拦。
两种情况的通用排查相同，先做下面四步。
通用四步
1. 回官网重新复制链接
从微信、QQ、截图、笔记里复制的链接经常被截断或多了空格——订阅链接末尾通常带 token= 之类的参数，少一个字符就失效。登录机场官网用户中心，点“复制订阅链接”重新复制，不要手打。
2. 确认格式匹配
机场通常提供三种格式：
| 格式 | 用于 | 识别 |
|---|---|---|
| Clash 订阅 | Clash 系、Stash | 浏览器打开是 YAML 文本，开头有 proxies: |
| 通用订阅 | Shadowrocket、v2rayN、v2rayNG、Quantumult X | 浏览器打开是一长串 base64 字符 |
| sing-box 订阅 | sing-box、Hiddify | 浏览器打开是 JSON |
用 Clash 读通用订阅、用小火箭读 Clash 订阅，都可能报“解析错误”。官网用户中心一般按客户端分别给按钮，点对应的那个。
3. 看机场有没有换域名
订阅链接里包含机场的域名。域名被封或更换后，旧链接会“无法获取”。去官网公告、Telegram 频道看最新域名，登录新域名重新复制订阅。
4. 先开代理再更新
部分机场的订阅服务器在海外，国内直连不通，表现为“更新超时”。先用任意一个还能用的节点开启代理，再点更新订阅；客户端里通常也有“通过代理更新”选项。
在浏览器里验证链接
把订阅链接直接粘到浏览器地址栏打开：
- 返回一长串文本（YAML、base64 或 JSON）：链接有效，问题在客户端。
- 返回 404、空白或登录页：链接失效或被截断，回第 1 步。
- 打不开 / 超时：域名不通，回第 3、4 步。
这一步能把“链接问题”和“客户端问题”立刻分开。
按客户端排查
Clash Verge / Clash 系
- 提示 YAML 解析错误：拿到的不是 Clash 格式，或者订阅里有 Meta 内核才支持的字段（VLESS、Hysteria2 等）而你用的是老版 Clash。换 Clash Verge、Nyanpasu 这类 Meta/Mihomo 内核客户端。
- 导入成功但节点列表为空：机场把节点放在
proxy-providers里按需拉取，而拉取失败。先开代理再更新一次。 - 一键导入按钮没反应：浏览器没有把
clash://协议交给客户端。手动复制链接粘贴即可。
Shadowrocket（小火箭）
- “无法获取”：先关闭小火箭的全局开关再更新；仍失败则先连上任意可用节点再更新。
- 导入后节点为空：粘的是 Clash 订阅。换通用订阅或机场提供的小火箭专用地址。
- 部分节点无法连接：小火箭版本太旧，不支持 Reality、Hysteria2 等新协议，更新 App。
v2rayN
- “订阅更新失败”：菜单“订阅分组设置”里勾选“通过代理更新”，或者先连上节点。
- 节点出现但连接失败：Xray 内核没更新，菜单“检查更新 → Xray 核心”；再看日志里是否有时间或 TLS 错误。
- 系统代理没生效：主界面底部选“自动配置系统代理”，浏览器才会走代理。
sing-box / Hiddify
- 配置导入失败：sing-box 需要它自己的 JSON 格式，通用订阅要经过转换。用机场提供的 sing-box 订阅，没有的话用机场说明里的转换地址。
- 版本不兼容：sing-box 配置格式随版本变化较快，客户端与订阅生成的版本不匹配会报错，更新客户端到最新版。
还是不行
四步通用排查 + 客户端排查都做完仍失败，把客户端日志里的错误原文发给机场客服，比描述“导入不了”有用得多。客服联系不上，按 机场客服联系不上怎么办 处理。
延伸阅读
- 订阅、节点、客户端的关系：新手理解订阅、节点与客户端
- 导入成功但节点全红：机场节点全红、显示超时怎么办
- 各客户端导入步骤：问答库 · 订阅导入与客户端