适合遇到“订阅更新失败”“导入后没有节点”或“更新完成但列表为空”的用户。按地址、响应内容、编码、网络路径依次检查，先区分下载失败与解析失败，再分别在 v2rayN 和 v2rayNG 中验证；已有可用配置先保留，不要通过反复删除订阅来试错。
先分清：请求失败，还是解析为空
订阅更新不是一次“连接节点”的测试。客户端先向订阅服务器请求内容，再把返回文本解析成配置，最后写入对应分组。节点能够连接，不代表订阅入口仍有效；订阅更新成功，也不代表新节点的传输与认证参数一定可用。
先记下更新时间、分组名称以及日志里最早出现的错误。日志入口随界面版本有所不同，查看主界面的日志区域或日志窗口即可。后面的“没有可用配置”可能只是前面请求失败的结果，应优先处理最早的错误。
- 超时、域名解析失败、连接被拒绝：请求没有拿到可用响应，优先检查网络路径，不急着修改 Base64。
- 收到响应，但提示格式错误或导入数量为零：重点看返回内容是不是订阅，以及客户端是否支持该格式。
- 提示更新成功，界面却没有条目：先切回目标分组，清空搜索和筛选，再确认响应是否确实包含节点。
地址自查：复制订阅入口，不是账户页面
常见错误是复制了账户面板地址、购买页面地址或浏览器跳转后的登录地址。这些网址可以正常打开，却通常返回网页，而不是客户端需要的订阅文本。应从服务提供方的订阅区域复制适用于当前客户端的完整地址。
-
保留旧配置
先记录现有分组与更新结果。需要备份时使用客户端的导出功能，将备份留在本机；不要先删除仍然可用的节点。
-
打开分组设置
v2rayN 主界面进入「订阅分组」→「订阅分组设置」，选中出问题的分组，检查订阅地址栏，而不是编辑某一条节点的服务器地址。
-
重新复制地址
从提供方页面重新复制完整订阅链接。检查开头的协议、结尾的令牌，以及中间是否被聊天软件插入换行；去掉误带的引号和首尾空白，不要改动地址内部字符。
-
单组更新
保存后仅更新这个分组，观察日志。部分界面通过选中分组或右键菜单更新；先隔离故障分组，避免多个订阅的错误混在一起。
地址中的查询参数常常承担身份认证作用。字符 & 用于分隔参数，%2F 等序列属于 URL 编码，不能凭感觉删改。若从网页源代码复制出了字面文本 &，参数可能被破坏；应回到页面的复制按钮获取原始地址，而不是手动逐段修补。
响应检查：HTTP 成功不等于格式正确
HTTP 状态码帮助判断服务器是否接受了请求，但它不能证明内容可导入。下面三个数字是标准响应状态，不是本站的实测数据，也不是节点延迟。
在本机浏览器检查订阅时，可能看到纯文本、下载提示或登录页面。浏览器拥有账户 Cookie，而客户端未必拥有，因此“浏览器能打开”只能作为线索，不能作为客户端请求成功的结论。不要把浏览器登录状态当成订阅认证的一部分。
| 看到的内容 | 可能原因 | 下一步操作 |
|---|---|---|
<!DOCTYPE html> 或登录表单 | 拿到了网页、验证页或错误页 | 重新获取客户端订阅入口，检查账户状态与访问限制 |
| 正文为空 | 订阅没有分配节点，或服务端返回空内容 | 确认账户有效期、套餐状态和提供方后台的节点列表 |
多行 vmess://、vless:// 文本 | 可能是逐行分享链接订阅 | 确认客户端支持对应协议及链接参数 |
| 一长串编码文本 | 可能是 Base64 包装的订阅，也可能不是 | 仅在本机查看解码结果，确认是否得到可识别的分享链接 |
| YAML、JSON 或结构化错误消息 | 选错订阅格式，或收到接口错误响应 | 在提供方页面选择适用于当前客户端的输出格式 |
不要因为文件扩展名是 .txt 就认定格式正确，也不要因为地址没有扩展名就判定它失效。真正决定导入结果的是响应正文和客户端解析能力。服务端还可能根据请求头返回不同格式，手动伪装请求头不是首选修复方式。
编码检查：先确认格式，再处理 Base64
常见订阅形式包括逐行分享链接，以及对整份链接列表进行 Base64 编码后的文本。Base64 是编码，不是加密。某些 vmess:// 分享链接内部也使用 Base64，但这与整份订阅的外层编码不是同一层。
- 外层订阅：解码后通常能看到一条或多条分享链接，应逐行检查是否存在完整的协议前缀。
- VMess 链接内部：常见形式是编码后的 JSON；内部内容被截断，即使外层订阅解码成功，也可能导入失败。
- VLESS 链接：通常采用 URI 结构，通过查询参数描述传输与安全设置，不应把整条链接强行当作 Base64 解码。
- 填充字符：末尾缺少
=不一定代表损坏；部分实现支持省略填充。不要仅凭这一点修改原始内容。
复制截断、把 + 误变成空格、插入全角标点，都可能破坏编码。换行是否被容忍取决于解析器；原样重新获取通常比人工拼接更可靠。如果本机查看到解码结果仍是另一层编码，也不要反复套用编码来“修好”订阅，应让提供方输出客户端支持的标准格式。
网络检查：分别验证直连与代理更新
更新订阅的请求路径，与普通网页的访问路径不一定相同。v2rayN 的订阅菜单可提供不通过代理和通过代理的更新入口，具体措辞随版本变化。切换系统代理，并不必然改变客户端自身的订阅请求方式；TUN 开启时，也可能继续影响原本打算直连的请求。
- 先试不通过代理：在 v2rayN「订阅分组」菜单选择「更新全部订阅(不通过代理)」，或对应的单组直连更新入口，记录结果。若正在使用 TUN，先确认它是否接管了这次请求。
- 再试通过代理：仅在已有节点能正常访问网络时，使用「更新全部订阅(通过代理)」或对应单组入口。旧节点全部失效时，这条路径可能没有可用出口。
- 检查本地监听：进入「设置」→「参数设置」，查看实际的本地监听端口。若日志显示连接本地回环地址被拒绝，确认内核运行正常、端口未改动且未被其他程序占用。
- 换网络复测：在允许的情况下换用另一条网络，只改变这一项。若同一地址在另一网络成功，优先检查原网络的 DNS、访问策略或连接质量。
证书错误需要单独处理。先开启系统时间自动同步，再确认订阅域名拼写、证书有效期，以及当前网络是否有登录认证页面。不要用关闭 TLS 验证作为长期修复；它既不能修复地址失效，也会削弱订阅内容的传输保护。
报错：401 Unauthorized
原因：请求的认证信息缺失、过期或不被服务器接受。解法：从提供方后台重新获取订阅地址，确认令牌完整，不要只重试旧链接。
报错：403 Forbidden
原因：服务器拒绝此次访问，可能涉及账户状态、来源限制或验证页面。解法：核对后台状态，对照直连与代理结果，并联系提供方确认限制。
报错：404 Not Found
原因：请求路径不存在，或服务端以此状态隐藏失效入口。解法：重新复制当前订阅入口，检查是否使用了旧域名、旧路径或被截断的地址。
以上为常见 HTTP 错误原文，客户端日志可能额外附带状态码或本地化说明。不要把服务器返回的错误页再交给 Base64 解码器；先解决请求层错误，才有可供解析的订阅正文。
客户端复测：一次只改变一个条件
v2rayN 是桌面客户端，v2rayNG 是使用 Xray 内核的安卓客户端。订阅获取与解析主要由客户端处理，因此更换内核不是订阅错误的通用解法。只有日志明确涉及某项配置或内核能力时，才进一步检查兼容性。
- v2rayN：在「订阅分组」→「订阅分组设置」确认目标分组和 URL，保存后更新，随后切回该分组并清空搜索条件。对比更新前后的条目，不要只看弹出的完成提示。
- v2rayNG：主界面右上角菜单进入「订阅分组设置」，核对分组地址；返回主界面，在菜单中执行「更新订阅」。菜单名称可能随版本调整，以当前界面显示为准。
- 跨设备比较：使用同一个仍有效的订阅入口，记录客户端版本、更新时间和所在网络。不同客户端可能支持不同输出格式，不能仅凭另一设备成功就断言本机网络正常。
- 恢复顺序：先恢复正常更新，再检查单条节点是否能用，最后恢复需要的系统代理、TUN 与路由分流设置。不要同时改地址、DNS、内核和路由。
常见追问：更新完成却仍没有节点
显示更新成功，为什么列表还是空的？
先选中刚更新的订阅分组，清除关键词与筛选条件，再检查日志中的导入数量。请求成功但内容为空、格式不匹配或条目均被过滤，都可能没有可见节点；应对照响应正文判断。
浏览器能打开，客户端为什么报错？
浏览器可能携带登录 Cookie，也可能走了不同代理。先确认打开的是订阅正文而非账户网页，再分别测试客户端的直连与代理更新路径，不要把浏览器的登录链接填进订阅栏。
旧节点都失效了，还能通过代理更新吗？
如果没有可用代理出口，通过代理更新通常无法解决问题。先尝试直连，或在另一条可访问订阅入口的网络下更新；仍失败时，让提供方确认入口可达性和账户状态。
发给服务提供方哪些信息才有用？
提供客户端名称与版本、发生时间、HTTP 状态码、直连和代理各自的结果，以及遮蔽敏感字段的错误日志。完整订阅地址只通过对方认可的私密渠道提供，不发到公开讨论区。
最终判断可以收敛成三项：地址是否仍有效，响应是否是客户端支持的订阅格式，请求路径是否可达。把这三项分开验证，比连续点击更新或重装客户端更容易定位问题。确认客户端版本过旧时，再从下载页选择合适安装包，并保留原配置备份。