VPN 订阅更新失败，常见表现包括客户端提示更新超时、导入后节点数量异常、原有节点突然消失，或节点仍在列表中却无法连接。这些现象不一定代表订阅失效：网络暂时不可用、订阅链接复制不完整、客户端格式不兼容、配置被覆盖，都可能造成相似结果。排查时先保留现有配置和订阅信息，不要一上来就删除客户端或反复重装；按“账号与订阅状态、设备网络、链接有效性、客户端配置”逐项检查，更容易找出原因，也能减少误删分流规则的风险。
还要先区分两种情况：一种是客户端无法从订阅地址获取配置，属于更新问题；另一种是配置已成功获取，但节点连接失败，属于连接或线路问题。前者重点看链接、网络与客户端解析，后者再检查节点选择、代理模式和系统网络设置。两者同时发生时，也应先让订阅成功更新，再单独测试连接。
先判断是订阅失败还是节点连接失败
先查看客户端的更新时间、更新提示和节点列表。若更新时间没有变化，并显示超时、无法解析、连接失败或格式错误，说明客户端可能没有成功读取订阅。若更新时间已刷新，但节点列表为空、节点数量明显变化，则应检查链接对应的配置内容、客户端兼容性和是否导入了正确订阅。若节点仍显示在列表中，只是连接不上，则订阅本身可能已经更新，问题更可能在网络路径、节点状态或客户端运行模式。
检查时不要只凭“节点消失”判断订阅过期。有些客户端会把订阅配置与手动添加的节点分开显示；切换配置文件、分组或订阅来源后，原节点可能只是没有显示在当前页面。规则模式、代理组和节点列表也不是一回事：订阅提供节点信息，规则决定哪些请求使用代理，代理组则可能决定实际选择哪个节点。先确认当前选中的配置文件和节点分组，再做删除或重新导入操作。
| 现象 | 优先检查 | 暂时不要做 |
|---|---|---|
| 更新时提示超时或网络错误 | 设备联网状态、当前网络是否拦截请求、客户端是否能访问订阅地址 | 不要立刻删除原配置 |
| 提示链接无效或解析失败 | 订阅是否过期、链接是否完整、客户端是否支持该订阅格式 | 不要将订阅链接粘贴到公开检测网站 |
| 更新成功但列表没有节点 | 订阅来源、当前配置文件、节点分组和客户端解析结果 | 不要连续导入多个相同配置 |
| 节点可见但无法连接 | 网络环境、节点选择、系统代理或 TUN 模式 | 不要把它直接当成订阅更新失败 |
如果账号页面可以查看订阅状态，先确认服务是否仍在有效期内，以及订阅是否因账号状态、流量或配置变更而需要重新获取。若刚更改过订阅设置，旧链接可能已不再对应当前配置，应从服务提供方的账户页面重新复制最新链接。不要通过他人转发的链接替换自己的订阅，也不要把配置文件与订阅地址混为一谈：配置文件是客户端保存的设置，订阅地址则用于获取或更新配置内容。
按步骤刷新订阅并恢复配置
开始操作前，记下客户端名称、当前配置名称和错误提示；若客户端支持导出配置或备份，先保存一份。不同应用的菜单名称会随版本变化，以下步骤按操作目标说明，不要求每个客户端的按钮名称完全相同。排查期间一次只改变一个条件，例如先换网络再更新，而不要同时清缓存、改 DNS、换节点和重装客户端，否则很难确认哪项操作起了作用。
- 确认设备能正常联网。暂时关闭当前代理连接，用浏览器打开常用网站，确认 Wi-Fi 或移动数据本身可用。若所有网站都无法访问，先处理路由器、移动网络或系统网络问题；订阅更新依赖设备能够访问订阅服务。
- 检查订阅状态并重新复制链接。确认账户状态正常后，从可信的账户页面重新复制订阅链接。不要手动删改链接末尾字符，也不要把链接复制进会自动清理特殊符号的聊天框或文档后再取回。
- 检查链接是否完整。将链接粘贴到客户端专门的订阅输入栏，留意首尾空格、换行、漏掉的字符和复制到一半的情况。不要把链接粘贴到浏览器地址栏进行公开检查，也不要通过不明网站验证链接内容。
- 在原订阅上执行更新。先使用客户端的更新、刷新或重新获取功能，等待操作结束并查看结果提示。若客户端支持自动更新，手动更新一次仍失败时，可以确认自动更新开关和更新时间设置，但不需要频繁重复请求。
- 确认配置和分组。查看更新后是否切换了配置文件、订阅来源或代理组。某些客户端不会把新节点自动设为当前使用节点；即使节点已导入，也需要在节点页面或代理组中选中可用线路。
- 必要时重新导入。只有在确认链接有效、客户端支持该格式且普通刷新无效后，再添加订阅或重新导入。保留旧配置直至新配置能够正常显示，确认无误后再清理重复条目。
- 最后再清理缓存或重启。退出并重新打开客户端，仍有异常时再使用应用提供的清理缓存功能。清理前确认它不会同时删除订阅、用户配置或手动规则；不确定时先备份，避免为了刷新节点丢失自定义设置。
兼容客户端对订阅内容的要求并不完全相同。Clash Verge 通常需要能识别对应配置格式的订阅内容；sing-box 使用自己的配置结构或受支持的导入方式；Shadowrocket 则应通过其支持的订阅导入流程添加配置。客户端提示格式错误时，不要仅靠改文件后缀或反复粘贴解决，应确认服务提供的订阅类型与客户端兼容。一个客户端成功导入，也不代表另一客户端能直接读取同一配置。
如果使用的是服务提供方的官方客户端，优先使用应用内的账户同步或订阅刷新功能；若使用第三方客户端，再确认订阅类型、导入入口和当前配置文件。不要同时让多个代理客户端接管系统网络，这可能导致系统代理、虚拟网卡或 DNS 设置互相影响。排查更新失败时，可先退出其他代理应用，再只保留正在检查的客户端。
Android、iPhone、Windows 和 macOS 的检查重点
Android：检查后台限制与网络切换
Android 上可先在 Wi-Fi 与移动数据之间切换一次，确认问题是否只发生在一种网络下。系统的省电策略、后台数据限制或应用休眠可能让客户端在切到后台后无法完成更新；可检查应用的网络权限、后台数据和电池优化设置。若客户端显示已连接但订阅列表未刷新，回到应用内确认当前订阅来源并手动更新。清除应用数据会比清理临时缓存影响更大，可能移除已保存的配置，因此不要把“清除数据”当作普通刷新操作。
iPhone：确认网络权限和配置状态
iPhone 上先确认当前 Wi-Fi 或蜂窝网络可正常使用，并检查客户端是否仍保有系统 VPN 配置授权。若最近删除或重装过应用，系统配置可能需要重新授权；这与订阅链接是否有效是两个不同问题。更新成功后仍看不到节点时，确认应用显示的是刚更新的订阅，而不是旧配置或手动配置。若系统提示 VPN 配置被移除或需要确认，应通过客户端正常流程重新建立配置，不要安装来源不明的描述文件。
Windows：检查权限、代理占用与客户端状态
Windows 上先确认客户端没有被退出，且不是仅关闭了窗口而仍在后台运行。若更新按钮无响应，可退出其他代理软件后重新打开当前客户端，再检查系统代理是否被另一个程序修改。使用 TUN 或虚拟网卡模式的客户端，还要留意驱动状态、权限提示和网络适配器是否正常；订阅更新本身失败时，切换 TUN 并不一定能解决问题，先确保设备可直接访问订阅服务。企业或校园网络可能限制部分连接，可在获准使用的其他网络环境中对照测试。
macOS：检查网络扩展与系统代理
macOS 上可以先退出客户端再重新打开，检查系统设置中与 VPN、网络扩展或代理相关的授权状态。系统升级、应用更新或重新安装后，扩展可能需要再次允许；如果客户端提示权限不足，应通过系统设置确认应用请求，而不是重复导入订阅。若订阅已经刷新而应用流量仍不符合预期，再检查系统代理或虚拟网络模式是否由当前客户端接管，以及其他网络工具是否仍在运行。
- ✅ 先备份或保留旧配置，确认新订阅正常后再删除重复条目。
- ✅ 记录错误提示、客户端名称和发生问题的网络环境，便于定位。
- ✅ 用不同网络做对照时，一次只切换网络条件，避免同时改动多项设置。
- ❌ 不要把完整订阅链接、二维码或含凭据的配置文件发到公开社区。
- ❌ 不要因为节点暂时不可见就反复重装客户端或清空全部应用数据。
刷新后仍失败时，如何安全求助
完成基本检查后仍无法更新，可以向服务提供方支持人员说明问题，但要提供足够的信息帮助复现。描述客户端及版本、设备平台、问题发生的大致时间、使用 Wi-Fi 还是移动网络、更新时显示的错误文字，以及节点是全部消失还是只有部分配置未显示。可以附上遮挡敏感信息的截图；不要发送完整订阅地址、登录凭据、可直接导入的配置文件或未打码的二维码。
如果更新提示超时，说明你已经确认设备可以正常联网，并在其他可用网络下做过对照会有帮助。如果提示格式错误，说明客户端名称、导入方式和订阅类型；如果订阅更新成功但节点不能连接，则补充所选节点、客户端运行模式和连接错误。这样能够区分账号订阅、格式兼容、设备权限与线路连接问题，避免支持人员只能从“无法使用”重新询问全部背景。
向支持人员提供诊断日志前，先查看客户端是否包含订阅 URL、访问令牌、账号标识或本地 IP 等敏感字段。日志与截图应只通过官方支持渠道提交；如果不确定日志会包含什么，先询问是否需要，或只提供经过遮挡的错误摘要。不要让陌生人远程控制设备，也不要根据非官方教程关闭系统安全功能、安装未知根证书或下载来历不明的客户端。
常见问题
订阅更新成功，为什么节点还是空的？
先确认客户端当前显示的是正确的配置文件和订阅来源，再检查节点分组、筛选条件及导入格式。部分客户端会保留旧配置，但不会自动切换到刚更新的配置；若确认订阅内容为空或格式不兼容，应从可信账户页面重新获取链接并确认客户端支持该类型。
订阅链接能打开，是否就说明链接有效？
不能只凭浏览器页面判断。订阅内容可能需要客户端按特定格式解析，浏览器显示文本、下载文件或返回错误，都不一定等同于客户端导入结果。请优先在客户端提供的订阅入口更新，并避免将包含凭据的链接交给第三方检测网站。
重新导入后，原来的配置可以马上删除吗？
建议先保留原配置，确认新订阅能够正常显示并完成连接测试后，再删除重复条目。若旧配置里有自定义规则、代理组或手动节点，删除前应备份或确认这些内容可以恢复。
什么时候需要联系支持人员？
确认账号状态、网络连通、链接完整和客户端兼容性后仍无法更新，或账户页面显示异常时，可以联系官方支持。提供平台、客户端、错误提示和已尝试步骤即可；提交截图或日志前务必遮挡订阅链接、令牌和个人信息。