适合 v2rayN、v2rayNG 与 v2flyNG 用户在“更新失败”“导入后为空”时逐项自查。先区分下载失败与解析失败，再检查链接、返回正文、Base64 和节点字段；最后用单节点导入验证范围，避免把订阅问题误判成内核或 DNS 故障。
先分清：请求失败、解析失败与连接失败
订阅更新包含几个独立环节：客户端请求订阅地址，服务端返回内容，客户端识别格式并生成节点，内核再根据节点配置建立连接。列表为空只说明没有得到可显示的条目，不能直接推出服务器离线。尤其是“更新成功但没有节点”，还可能与分组筛选、空响应或全部条目被过滤有关。
| 表现 | 优先检查 | 暂时不要做 |
|---|---|---|
| 超时、域名解析失败 | 订阅域名、当前网络、更新是否经过代理 | 反复修改节点协议 |
| 收到内容但提示格式错误 | 响应正文、编码方式、客户端支持的格式 | 把网页正文当作节点导入 |
| 更新后列表为空 | 返回内容是否为空、分组与筛选、订阅权限 | 立即清空全部已有节点 |
| 节点已出现但连接失败 | 节点参数、内核支持、安全层与服务端状态 | 继续围绕 Base64 排查 |
先保留当前配置备份，并记录更新时的完整提示。若已有可用节点，不要为了重试删除原分组。新建一个测试分组更容易比较结果，也能防止一次异常更新影响日常使用。
链接完整性：订阅地址不是单节点分享链接
订阅地址通常是 https:// 开头的资源地址；单节点分享链接则可能以 vmess://、vless:// 或 trojan:// 开头。前者应添加到订阅分组后执行更新，后者应通过客户端的分享链接导入入口处理。把节点链接填进订阅地址栏，客户端可能直接拒绝，也可能在请求阶段失败。
-
重新复制
从服务方的订阅入口重新复制完整地址，粘贴到本地纯文本编辑器检查首尾。去掉误带的引号、换行和中文标点，不要手动删减查询参数。
-
核对入口
v2rayN 常见入口为「订阅分组」→「订阅分组设置」→「添加」；填入备注与地址后保存。不同版本文字可能略有差异，应选择订阅分组编辑入口，而不是单节点编辑窗口。
-
单独更新
回到「订阅分组」，选择「更新当前订阅（不通过代理）」进行一次测试；若界面将“当前”写为“所选”，先确认选中了刚添加的测试分组。
-
记录结果
记录更新时间、提示原文及节点数量是否变化。Android 端可在 v2rayNG 的「订阅分组设置」中核对地址，再通过主界面菜单「更新订阅」测试。
查询字符串里的 &、=、% 可能属于令牌或参数，不能按“看起来多余”删除。如果从网页源代码或消息转发内容复制后，地址里出现了字面量 &，应回到原始复制按钮重新获取，避免把 HTML 转义形式当成真实地址。
先看返回内容：HTTP 成功不等于订阅有效
在可信的本机环境检查响应时，需要同时看状态码与正文。浏览器能打开登录页面，只能证明网站可访问；客户端需要的是可识别的节点数据。带网页验证、登录重定向或错误提示的响应，即使状态码是 200，也可能无法解析。浏览器还可能带有登录 Cookie，因此浏览器访问成功不代表客户端请求一定成功。
- 正文以 HTML 标签开头：例如
<!DOCTYPE html>，多半返回了网页，不要继续尝试 Base64 解码。 - 正文是 JSON 错误对象：先读错误说明；不要因为扩展名或响应类型像数据文件就认定它是节点列表。
- 正文长度为零：核对订阅是否启用、套餐权限与服务方状态，也检查响应是否被网络设备截断。
- 状态码 429：表示请求过于频繁，应停止连续刷新，按服务方说明或响应中的等待时间稍后重试。
结论：先验证正文，再处理编码
如果响应是登录页、访问拒绝或空内容，重新编码无法生成有效节点；应先修复订阅访问条件，再测试客户端解析。
Base64 排查：看编码层次，不要盲目补字符
常见订阅格式之一，是将多行分享链接整体进行 Base64 编码；也有订阅直接返回明文分享链接。VMess 分享链接本身还常包含经过 Base64 编码的 JSON，因此外层订阅解码一次后仍看到 vmess:// 是正常现象，不代表解码失败。具体是否接受某种形式，由客户端的订阅解析器决定。
- 标准 Base64：字符表包含
+和/，末尾可能使用=补位。 - URL 安全变体：用
-和_替代上述两个字符；能否自动识别取决于解析器。 - 长度检查：去掉允许忽略的空白后，长度除以 4 的余数为 2 或 3，可能只是省略了补位；余数为 1 则通常意味着内容不完整或格式并非 Base64。
- 解码不等于有效：即便成功解码，结果仍需是客户端支持的节点数据。Base64 是编码方式，不提供保密性。
换行在不同实现中的容忍度不一样：有的订阅解析器会去掉空白，有的严格解码入口不会。先保存原始内容，再在副本上进行本地检查；不要全局替换节点 URI 内的字符，也不要把所有 = 删除。若内容在复制时被截断，补位只能改变语法外观，不能还原丢失的数据。
illegal base64 data at input byte 0
原因：Go 的 Base64 解码器在起始位置遇到不符合当前字符表的输入，例如把以尖括号开头的网页作为编码正文。
解法：先检查响应开头和原始格式；确认为网页时修复请求入口，不要继续补位。客户端可能仅显示简化后的“解析失败”。
unexpected end of JSON input
原因：JSON 解析器读到空内容或未结束的数据，可能出现在 VMess 分享数据解码后的字段解析阶段。
解法：重新获取完整内容，检查解码结果是否完整；不要通过手动补一个括号来猜测节点配置。
协议兼容性：能解码，也可能无法生成节点
订阅格式兼容与内核协议支持是两件事。图形客户端先把订阅转换为自己的节点配置，之后才交给内核运行。v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核；v2rayN 则要核对当前实际选用的内核。不能因为两款客户端都能识别 VMess，就推断它们支持完全相同的传输参数和安全层组合。
| 检查项 | 具体检查内容 | 常见影响 |
|---|---|---|
| 服务端端口 | 应为 1–65535 的整数；443 只是常见配置，不是固定值 | 缺失或超范围可能无法导入 |
| 身份凭据 | VMess、VLESS 核对 UUID；其他协议按其格式核对密码 | 错误凭据可能导入成功但认证失败 |
| 传输参数 | 传输类型、WebSocket 路径、Host 等须与服务端匹配 | 字段不支持可能丢失，填错则连接失败 |
| 安全层 | TLS 的 serverName；REALITY 的公钥、shortId 及相关设置 | 需要客户端解析器与内核共同支持 |
REALITY 是安全层机制，不是独立出站协议。不要只把节点名称改成“REALITY”就认为完成了适配。若服务方提供按客户端区分的订阅入口，应选择明确适用于当前客户端的格式；结构化配置文件也不能一概当作分享链接列表导入。
- 在测试分组中保留原订阅，使用服务方提供的一条完整分享链接进行单独导入。
- 若单节点能导入而整个订阅失败，优先检查外层编码、订阅返回格式与内容截断。
- 若只有某类节点消失，核对该类协议与传输字段的支持情况，不要删除必需参数来强行导入。
- 若节点能显示但启动内核时报错，转向内核配置日志排查，区分“不支持配置”与“网络连接失败”。
订阅时效与更新路径：最后做一次受控复测
订阅链接失效与节点连接失效没有一一对应关系。重置令牌可能让旧链接立即不可用，而此前缓存的节点仍能显示；套餐到期也可能返回空列表、说明文字或拒绝访问，具体行为取决于服务方。检查账户有效期、剩余使用权限和最新地址，比重复导入同一个旧链接更有价值。
订阅请求的网络路径也需要单独确认。“通过代理更新”依赖当前代理已经可用；若正在使用的节点失效，更新可能陷入依赖循环。反过来，如果直连无法访问订阅域名，而已有一个经确认可用的节点，通过代理更新才有意义。一次只切换一个条件，才能知道究竟是哪一项生效。
- 直连测试一次：在 v2rayN 的「订阅分组」中使用不通过代理的更新入口，记录提示，不连续点击。
- 代理测试一次：先确认所选节点能建立连接，再使用「更新当前订阅（通过代理）」；菜单措辞以实际版本为准。
- 核对系统时间：明显错误的日期可能导致 HTTPS 证书有效期判断失败，应恢复系统自动校时，而不是关闭证书验证。
- 检查显示范围：切换到正确分组，清除搜索词和筛选条件；列表不可见不一定意味着数据没有导入。
结论：按失败阶段提交信息
仍无法解决时，向服务方提供客户端名称与版本、更新时间、请求状态和脱敏报错；说明直连与代理更新的不同结果，不发送完整订阅令牌或节点凭据。
复测成功后，再确认节点字段是否完整、内核能否启动以及实际连接是否正常。这三步分别验证“订阅可解析”“配置可运行”“线路可连接”，不要只看到更新成功提示就结束检查。需要整理导入操作时，可继续查看订阅使用教程；涉及格式转换时，先阅读订阅转换注意事项，避免将访问凭据交给不可信服务。