sing-box Android 订阅更新失败怎么办？按报错逐项排查
简答：先不要反复重装：在 Android 的 sing-box 客户端中记录完整报错，关闭正在运行的 VPN 后重新更新，并用手机浏览器检查订阅链接返回内容。若浏览器也打不开，优先检查链接、账户或网络；若能打开但客户端解析失败，再检查订阅格式与核心版本。
定义：sing-box Android 订阅更新失败，是指客户端无法从远程 URL 下载、解析或保存新的 sing-box 配置，和节点启动后无法联网是两个不同问题。
先看报错：一分钟判断问题在哪一层
本文是第三方使用指南，不是任何客户端或订阅服务的官网。Android 上的 sing-box 图形客户端通常把远程配置作为 Remote Profile 管理，远程配置的更新来源是一个 URL；官方客户端文档还说明，图形客户端应支持远程配置自动更新和 HTTP Basic 认证。官方客户端通用说明
| 现象或报错 | 优先判断 | 先做什么 |
|---|---|---|
| 404、403、401 | 链接失效、权限限制、认证或订阅状态异常 | 重新复制完整订阅地址，并核对账户、有效期、访问权限 |
| 429 | 请求频率或服务端限制 | 停止连续刷新，稍后重试；不要反复删除和重建配置 |
| 连接超时、无法建立安全连接 | 当前网络无法访问订阅服务器，或 TLS/证书链异常 | 分别测试 Wi-Fi 与移动数据，并检查 Android 系统时间 |
| Parse Error、JSON 错误 | 返回内容不是客户端可解析的 sing-box 配置 | 用浏览器检查返回的是配置文本、登录页、验证码页还是错误页 |
| Schema Error、字段未知 | 配置字段与当前 sing-box 核心或客户端版本不匹配 | 备份旧配置，核对迁移说明，要求重新生成兼容配置 |
| 更新成功但没有节点 | 返回的是空配置、格式不对，或客户端只保存了基础配置 | 打开配置内容查看器，确认是否存在 outbounds 或节点信息 |
| 节点出现但无法上网 | 订阅更新已成功，问题转为启动、路由、DNS 或节点连接 | 停止继续刷新订阅，改查运行日志与连接状态 |
表格中的状态码和错误文字需要以客户端实际显示为准。不要把“订阅下载失败”和“节点连接失败”混为一类，否则更换 DNS、重装应用通常不能解决真正原因。
最短排查流程：按这个顺序重试一次
- 记录错误原文。截图或复制完整提示，同时记下 Android 版本、sing-box 客户端名称、客户端显示的核心版本、当前网络类型，以及是否开启了 VPN。
- 先停止正在运行的 VPN。如果 sing-box 当前已经接管 Android 流量，更新请求可能经过自身代理，也可能因为配置异常而失败。先停止服务，再执行一次更新；界面名称以当前 Android 客户端版本为准。
- 重新复制订阅地址。从提供订阅的账户页面重新复制完整 URL，检查是否包含遗漏字符、换行、空格或被聊天软件截断。不要把网页登录地址、Clash 格式地址或 Base64 文本直接当作 sing-box 专用配置，除非服务端明确说明兼容。
- 用同一台手机浏览器访问。在浏览器中打开订阅 URL，观察返回结果。若出现登录页、验证码页、HTML 错误页或空白页，而不是预期的配置内容，问题通常在链接、权限、账户状态或服务端返回格式。不要公开包含 Token、密码或完整订阅参数的地址。
- 切换一次网络。在 Wi-Fi 和移动数据之间各测试一次，并记录哪一种网络可以访问。若只在某一网络失败，优先检查该网络的 DNS、代理、家长控制、企业网络策略或防火墙；不要同时改变多个条件。
- 校准系统时间。Android 的日期、时间和时区应使用自动设置。时间明显错误时，HTTPS 证书校验可能失败；调整后重新打开客户端再测。
- 重新添加而不是覆盖旧配置。先保留旧配置作为回滚，再新建一个远程配置测试。若新配置能更新，说明原配置的 URL、认证信息或本地状态可能已经过期；确认无误后再删除旧项。
Android 的 VPN 设置由系统统一管理，系统设置中可以查看 VPN 项；如果设备存在始终开启 VPN、其他 VPN 应用或工作配置文件，先确认是否有多个应用同时争抢 VPN 权限。Google Android VPN 设置说明
按错误类型处理：链接、格式、版本和网络分别排除
1. 浏览器也打不开：先处理链接或访问条件
浏览器访问同一 URL 仍返回 404、403、401、429 或超时，说明客户端尚未进入配置解析阶段。此时重点核对订阅是否过期、流量或权限是否受限、Token 是否被重置，以及 URL 是否被复制不完整。若账户页面可以重新生成订阅，优先重新生成后再测试；具体账户状态和限制以提供订阅的一方为准，无法从客户端单独确认的内容不要猜测。
2. 浏览器能打开但客户端 Parse Error：检查返回格式
浏览器能访问不等于内容适合 sing-box。返回内容可能是 HTML 登录页、JSON 错误对象、Clash 配置、Base64 文本或 sing-box JSON。sing-box 官方配置文档明确说明配置文件使用 JSON，并提供 JSON Schema 与检查命令；因此不能只凭“浏览器显示有内容”判断配置有效。sing-box 配置文件说明
如果服务端提供多种格式，请选择明确标注为 sing-box、SFA 或 sing-box JSON 的订阅。若只有 Clash、Base64 或通用订阅入口，先向提供方确认是否支持当前 Android 客户端，不要把未经确认的转换结果直接覆盖旧配置。
3. Schema Error：不要盲改字段，先核对版本
sing-box 的配置字段会随版本演进。官方 Schema 页面说明，配置 Schema 可用于编辑器补全和校验，并可生成与当前已安装二进制匹配的 Schema。官方迁移文档也记录了旧字段到新字段的变化，例如 DNS 服务器格式在 1.12.0 发生过迁移。sing-box JSON Schema sing-box 官方迁移说明
Android 用户不建议直接照抄网上的 YAML 或旧版字段修复。正确做法是：先记录客户端与核心版本；保留旧配置；让订阅提供方按当前 sing-box 格式重新生成；若使用自建配置，再依据当前 Schema 校验字段。当前客户端具体版本和兼容范围需以客户端发布页、配置内容和实际日志核实。
4. 更新成功但没有节点：确认是不是“空配置”
打开远程配置的内容查看入口，检查是否真的出现节点出站，而不是只有空的 route、dns 或基础结构。sing-box 配置顶层包含 outbounds、route、dns 等部分，官方配置说明可用于核对结构。若返回内容为空、只包含错误对象，或没有可选择的出站，重新复制订阅并要求服务端检查生成结果。
5. 更新成功、节点也有，但无法连接：停止刷新，转查连接
这已经不是订阅更新故障。先在客户端日志中查看具体节点的超时、握手、TLS、DNS 或路由错误，再只测试一个节点。Android 客户端的 TUN 实现依赖系统 VPN 能力，官方 Android 客户端说明也将 TUN 透明代理列为平台相关功能；因此还要检查 VPN 权限、其他 VPN 应用、分应用代理范围和电池后台限制。sing-box Android 官方客户端说明 sing-box Android 功能说明
Android 上的复现记录与回滚方法
- 记录工具：手机浏览器、sing-box 客户端日志、Android VPN 设置页。
- 固定变量：同一订阅 URL、同一节点或配置、同一 Android 设备；一次只改变 Wi-Fi/移动数据、VPN 开关或客户端版本中的一个条件。
- 结果记录：写下测试时间、HTTP 状态码、错误原文、是否能看到配置文本、是否出现节点，以及更新后是否能启动 VPN。
- 安全处理：订阅 URL、Token、UUID、密码和完整节点参数全部脱敏，不要截图公开。
- 回滚：删除远程配置前先保留旧配置；如果新配置更新后无法启动，切回旧配置验证客户端本身是否正常。
如果问题出现在客户端升级之后，先查看官方发布说明和迁移页面，再决定是否降级或重新生成配置。当前发行版本、测试版与稳定版的具体差异需以发布页为准，不在没有证据时断言某个版本一定存在或一定兼容。sing-box 官方发布页
反馈给服务商时可直接整理：“Android 版本、客户端名称与版本、核心版本、Wi-Fi/移动数据、VPN 是否关闭、浏览器访问结果、HTTP 状态码、完整错误原文、是否能看到节点”。只提供脱敏信息，避免发送完整订阅链接。
常见问题
更新订阅时是否必须关闭 VPN？
不是绝对必须，但排查时建议先关闭正在运行的 VPN，再测试一次直连更新。这样可以区分“当前网络无法访问订阅服务器”和“旧配置或代理链导致更新失败”。若直连失败、通过已有节点访问成功，说明网络路径可能是重要变量；不要把代理套代理，避免形成循环。
手机浏览器能打开订阅链接，为什么 sing-box 仍然解析失败？
浏览器只证明 URL 返回了某种内容，不证明内容是当前客户端支持的 sing-box JSON。返回登录页、验证码页、错误页、Clash 配置或 Base64 文本，都可能导致解析失败。应确认服务端返回格式，并查看客户端显示的 Parse Error 或 Schema Error。
订阅更新失败是不是 DNS 问题？
可能是，但不能先假定。若浏览器和客户端都无法解析域名，可把 DNS 作为优先检查项；若浏览器能正常打开同一 URL，DNS 就不是首要嫌疑，应先查格式、认证、账户状态或客户端兼容性。
更新成功后没有节点，应该重装客户端吗？
通常不应先重装。先查看远程配置内容是否为空、是否包含可用出站，以及订阅是否误用了其他客户端格式。只有在新建远程配置、确认链接和返回内容正常后仍出现本地异常，才考虑备份数据后清理应用状态；清理前必须确认旧配置可以恢复。
如何判断是版本不兼容？
如果同一订阅在此前可用，而客户端或核心升级后开始出现字段未知、Schema Error 或配置加载失败，可以把版本兼容列为优先检查项。但这仍需用错误原文、当前配置和官方迁移说明核对，不能仅凭“更新过应用”下结论。
常见问题
更新订阅时是否必须关闭 VPN？
不是绝对必须，但排查时建议先关闭正在运行的 VPN，再测试一次直连更新，以区分网络访问问题和旧配置代理链问题。
浏览器能打开订阅链接，为什么客户端仍然解析失败？
浏览器只能证明 URL 返回了内容，不代表内容是当前 sing-box 客户端支持的 JSON。登录页、验证码页、错误页、Clash 配置或 Base64 文本都可能导致解析失败。
订阅更新失败是不是 DNS 问题？
可能是，但不能先假定。若浏览器也无法解析域名，再优先检查 DNS；若浏览器能打开同一 URL，应先检查格式、认证、账户状态和版本兼容性。
更新成功后没有节点，需要重装客户端吗？
通常不需要先重装。先确认远程配置是否为空、是否包含节点出站，以及是否误用了其他客户端格式；清理应用前应先备份旧配置。