先保留现有节点，再检查订阅地址与服务端响应，随后区分网络请求失败和内容解析失败。本文适用于 v2rayN 桌面端与 v2rayNG 安卓端；按顺序核对链接、更新路径、格式和系统时间，可以确定故障停在哪一层，避免反复删除订阅或更换内核。
先分清：没有下载到内容，还是内容不能解析
“更新失败”只是结果，不是原因。订阅更新通常由客户端发起 HTTP 请求，取得文本后解析节点，再写入对应分组。这个过程不等于节点连接测试，也不等于 Xray 或 V2Fly 成功启动。更新失败时，先看客户端日志中最早出现的错误，不要只看最后一行“导入失败”。
- 没有取得正文：优先检查域名解析、连接超时、代理路径、TLS 证书和 HTTP 状态。
- 取得正文但导入为零：优先检查是否返回登录页、错误提示、空文本或客户端不支持的订阅格式。
- 更新成功但节点不能用：转查服务器地址、端口、协议参数和路由规则，不再把问题归为订阅下载失败。
第一项：重新复制订阅地址，核对授权状态
最先排除链接本身的问题。订阅地址通常带有访问令牌，不能用账户首页、购买页面或单条节点分享链接代替。复制时漏掉查询参数、混入换行、把半角 & 变成文本 &，都可能让请求失去授权或指向错误资源。
-
保留旧分组
记录原分组和节点数量。先编辑订阅地址，不执行删除全部服务器，避免丢失仍可连接的节点。
-
复制专用链接
在订阅提供方的账户页面找到订阅导出入口，选择适用于 v2rayN 或 v2rayNG 的格式。使用复制按钮，避免从聊天截图或折行文本中拼接地址。
-
检查链接完整性
确认协议、域名、路径和查询参数完整，去掉首尾空白与包裹引号。令牌已重置时，旧地址通常不能继续使用，应重新复制。
-
只更新该分组
保存地址后只更新目标分组，记录一次完整结果。不要同时更新多个来源，否则日志中的超时和授权错误容易混在一起。
在可信的本机浏览器中打开订阅地址，可以辅助判断是否返回文本或下载文件。但浏览器可能携带登录 Cookie、使用不同代理或触发不同的服务端响应，因此“浏览器能打开”不能单独证明客户端也能成功。不要把完整地址粘贴到在线解码、测速或转换网站。
第二项：看 HTTP 状态，不把登录页当作订阅
HTTP 状态能缩小范围，但不能独立证明内容正确。以下数字是标准响应状态，不是测速结果。若客户端没有显示状态码，可查看其日志；提供方后台的请求记录也可用于辅助核对。
| 响应现象 | 优先判断 | 下一步 |
|---|---|---|
200，正文以 <!DOCTYPE html> 开头 | 返回网页，可能是登录、验证或错误页面 | 重新取得订阅专用地址，向提供方确认机器请求入口 |
401 或 403 | 凭据无效、权限限制或访问策略拦截 | 检查令牌与账户状态；403 不能直接等同于套餐过期 |
404 或 410 | 路径不存在，或资源已移除 | 从账户页面重新复制当前订阅地址 |
429 | 更新过于频繁或触发服务端限流 | 停止连续点击；若响应含 Retry-After，按其要求等待 |
5xx | 服务端或上游处理失败 | 保留旧节点，稍后重试并联系提供方 |
第三项：分别测试直连更新与代理更新
订阅域名与节点服务器不是同一个目标。节点可用，不代表订阅域名能直连；订阅能下载，也不代表节点可连接。v2rayN 的更新入口可能区分“不通过代理”和“通过代理”，应分别测试，不要只切换系统代理后就认定更新请求已经改变路径。
-
定位订阅设置
v2rayN 打开「订阅分组」→「订阅分组设置」，核对目标分组地址。不同界面版本措辞可能略有差异，以当前窗口中同义入口为准。
-
测试直连更新
在「订阅分组」中选择「更新当前订阅（不通过代理）」。只做一次测试，记录是否超时、证书失败或返回 HTTP 错误。
-
确认代理可用
选择一个此前已验证可用的节点并启动内核，再选择「更新当前订阅（通过代理）」。所有旧节点均失效时，这条路径不能凭空恢复连接。
-
核对安卓分组
v2rayNG 主界面右上角菜单进入「订阅分组设置」，检查地址并保存；返回主界面，选择目标分组后执行菜单中的「更新当前组订阅」。
-
重试并对照
v2rayNG 可在服务停止与已有可用服务启动后分别重试，比较日志结果。不能只凭 VPN 状态判断订阅请求路径，还要核对当前版本的更新选项及路由设置。
第四项：确认编码与订阅格式一致
常见订阅正文是多条分享链接，或这些链接组成的文本经过 Base64 编码后的结果。客户端需要先识别外层内容，再解析每个节点。单条 vmess:// 的载荷还可能有自己的编码层；不能把整个响应反复解码，直到“看起来像文字”为止。
- 分享链接列表：检查解码后的文本是否包含
vmess://、vless://或trojan://等客户端支持的方案，以及条目是否完整。 - 错误文档：JSON 对象如果只有
error、message等错误字段，通常是接口响应，不应当作为节点列表导入。 - 格式不匹配：一份 YAML 配置或完整内核 JSON 配置，不一定能当作订阅链接列表解析。应在提供方导出入口选择目标客户端格式。
- 传输损坏：截断的 Base64、被替换的字符、编码层次错误都可能导致解析失败。优先重新获取原始响应，而不是手动补字符。
若响应中混有空行、提示文字或部分不受支持的节点，客户端可能只导入其中一部分，也可能报告错误；具体取决于解析器实现。更新后的节点数少于原来时，应检查导入日志和提供方当前返回内容，不要直接推断节点被客户端删除。
订阅解析属于客户端功能，节点运行才涉及内核能力。遇到 VLESS 参数或其他协议字段不被识别时，先核对客户端版本与导出格式；仅把 Xray 换成 V2Fly，不能修复返回网页或损坏的 Base64。
第五项：按真实错误定位 DNS、TLS 与时间问题
以下是网络或解码库常见错误的原文片段，具体大小写、前缀和附加信息随客户端版本而异。它们不一定出现在同一个客户端中。阅读时保留错误发生阶段，避免把内核连接日志误当成订阅下载日志。
报错：No such host is known
原因：域名解析未取得可用结果，可能是地址拼写、系统 DNS 或网络环境问题。
解法：先核对订阅域名，再在同一网络重试；必要时对比另一可信网络，确认后再调整实际请求路径使用的 DNS。
报错：Connection refused
原因：目标地址端口拒绝连接；若目标是本机地址，通常应先检查本地代理是否监听。
解法：查看报错中的主机与端口，确认是订阅服务器还是本地代理，再分别检查远端服务或本地内核运行状态。
报错：x509: certificate has expired or is not yet valid
原因：证书有效期与设备当前时间不匹配，可能是系统时间错误，也可能是服务端证书确实过期。
解法：校准系统日期和时间后重试；若时间正确仍失败，应由订阅提供方处理证书，不要关闭证书验证。
报错：illegal base64 data at input byte 0
原因：交给 Base64 解码器的内容从起始位置就不符合预期，常见于格式错误或网页响应。
解法：检查响应正文的开头与导出格式，重新获取完整订阅；实际错误中的字节位置也可能是其他数字。
Windows 可进入「设置」→「时间和语言」→「日期和时间」，启用自动设置时间并执行同步。安卓可进入系统「设置」的「日期和时间」页面，开启网络提供的时间；厂商界面入口可能不同。时区主要影响显示，应同时确认实际日期与时刻正确。
更新成功后：验证分组，再测试节点
成功提示只说明本次更新流程完成。还应核对目标分组是否出现预期节点、是否误看了其他分组，以及是否存在重复条目。选择一个节点后再做连接测试，把“订阅导入完成”和“业务访问恢复”分别确认。
- 分组为空：检查是否选错分组、服务端是否返回空订阅，以及日志是否记录全部条目解析失败。
- 节点存在但测试失败：检查服务器地址、端口、TLS 主机名和协议参数；订阅已经成功时，不要反复重新生成令牌。
- 仅部分应用异常：检查系统代理、TUN 或应用自身代理设置，以及路由分流规则。这不属于订阅解析阶段。
- 需要求助：提供客户端名称、实际版本、系统、失败时间、更新方式和脱敏后的错误行；隐藏完整订阅地址、令牌、节点凭据与账户信息。
排查的停止条件也要明确：取得正确响应并成功导入后，就结束订阅层面的修改。若确认是授权失效或服务端错误，应保留可用配置，向提供方核对，而不是继续改动 DNS、端口和内核，扩大故障范围。