适用于已经从你的服务商处获取订阅链接，却在 Shadowrocket（小火箭）中遇到更新失败、导入后没有条目或原有列表不再变化的情况。先保留现有配置，再按五步检查；最终要分清是链接不对、服务器没有返回有效内容，还是内容已返回但未能解析，而不是一开始就删除订阅或改动全部网络设置。
先区分：订阅更新失败与连接失败
订阅更新的任务是取得一份服务器条目列表，并将内容解析为客户端可使用的记录。列表里已有条目但连接失败，是后续连接阶段的问题；列表为空，也不能直接推出所有服务器都不可用。延迟测试成功同样不能证明订阅地址可访问，因为测试目标与订阅服务器可能不是同一个地址。
排查前，在 Home 首页记录目标订阅的名称、当前条目数量与本次提示。如果仍有可用的旧条目，先保留它们；备份包含凭据的配置时，只存放在自己控制的位置。不要把“删除后重新添加”当作第一步，这会抹去前后对照所需的信息。
| 看到的现象 | 优先检查 | 暂时不能得出的结论 |
|---|---|---|
| 更新时报错，旧条目仍在 | 订阅请求和本次响应 | 旧条目已经全部失效 |
| 首次导入后没有条目 | 链接用途、响应内容和格式 | 必须更改连接协议 |
| 列表正常，但某条目无法连接 | 该条目的参数与出站网络 | 订阅一定没有更新成功 |
| 更新后数量减少 | 服务商实际返回的条目与筛选条件 | 减少的条目一定被客户端误删 |
第一步：确认拿到的是订阅链接，而不是网页地址
订阅链接从你的服务商处获取。账户首页、订单页面与帮助页面即使能在浏览器中打开，也不等于可导入的订阅地址；它们通常返回供人阅读的 HTML 页面，而不是条目数据。链接里出现“sub”字样也不足以证明用途，仍需核对服务商提供的导入说明。
https://example.com/sub?token=xxxx以上地址仅演示结构，不能用于实际连接。https:// 是协议部分，example.com 是主机名，/sub 是路径，?token=xxxx 是查询参数。真实地址的路径和参数名可能完全不同，不要按示例把自己的链接改成相同形式。
- 回到服务商提供链接的位置，确认其用途是客户端订阅，而不是网页登录入口。
- 区分一条服务器分享链接与包含多个条目的订阅地址；两者不能仅凭“复制链接”这一动作混为一谈。
- 需要重新核对添加位置时，从 Home 首页点添加入口，进入 Add Server 添加服务器，检查 Type 类型是否为 Subscribe 订阅，并核对 URL 地址字段。
- 不要在 Config 配置页面导入一份不明内容来代替订阅检查。规则配置与服务器订阅承担不同任务。
端口事实用于理解请求目的地，不是修改建议。如果原始订阅地址显式带有其他端口，应保持原值；订阅地址的端口也不等于列表内每个服务器的连接端口。
第二步：逐字符核对复制完整性
看起来相似的链接，可能因为一个字符不同而指向不同资源。常见问题包括复制了中文句号、只选中屏幕上显示的一段、漏掉问号后的参数，或者把排版后的换行一并贴入。先核对完整字符串，再尝试更新，比反复点击刷新更有诊断价值。
- 开头：检查是否带有多余引号、说明文字或空白，协议部分是否与原文一致。
- 中段：检查主机名、路径与显式端口，尤其注意相近字符和大小写；路径及凭据可能区分大小写。
- 结尾：检查查询参数是否完整，是否误带句号、逗号或聊天消息中的括号。
- 编码：保留
%2F、%3D等原始编码，不要手动解码，也不要擅自把&删除。 - 显示：界面为了省空间显示的省略号不一定属于实际地址；进入编辑字段核对，不要只看列表摘要。
重新复制时优先使用来源页面提供的完整复制操作，然后在目标订阅的 URL 地址字段中替换并保存。只改这一个变量，执行一次更新并记录结果。不要同时重命名分组、修改规则和切换协议，否则很难判断是哪项操作改变了现象。
第三步：核对服务商状态与返回内容
链接完整仍然失败时，应核对服务商侧状态：账户是否有效、订阅地址是否已经重置、当前服务是否处于维护状态，以及该地址是否存在访问频率或来源限制。客户端买断不等于线路套餐；购买 Shadowrocket 本身不能使一个失效的订阅地址恢复有效。
如果更新提示或可用的诊断记录包含 HTTP 状态码，可按下面的标准含义分类。卡片中的英文是 HTTP 状态表达，不代表每次更新都会显示完全相同的提示；没有状态码时，不要自行猜测服务器返回了哪一种错误。
HTTP 401 Unauthorized
原因与解法：请求未通过目标资源要求的身份验证，可能涉及凭据缺失或失效；核对完整参数，并向自己的服务商确认当前地址是否仍有效。
HTTP 403 Forbidden
原因与解法：服务器拒绝本次访问，可能与权限或访问策略有关；保留状态码与发生时间，让服务商核对拒绝原因，不要仅据此断言套餐已到期。
HTTP 404 Not Found
原因与解法：请求路径没有找到对应资源；检查链接是否截断、路径是否改变，再核对服务商提供的当前订阅地址。
HTTP 429 Too Many Requests
原因与解法：服务器对请求进行了频率限制；停止连续刷新，按服务商说明或响应中的 Retry-After 等待后再试。
即使收到 HTTP 200，也只能说明请求在 HTTP 层面得到成功响应，不能保证正文是有效订阅。登录页、验证页、空正文或格式不匹配的数据，都可能无法生成条目。若浏览器能显示内容，最多说明该次浏览器请求得到响应；浏览器的登录状态、缓存与客户端请求条件不一定相同。
结论：先确认返回的是什么，再处理解析
链接正确但列表为空时，向自己的服务商核对该地址是否返回适用于 Shadowrocket 的非空订阅内容；不要靠更换规则配置来修复登录页或空响应。
第四步：控制更新时机，只观察目标订阅
连续刷新不会修复失效凭据，反而可能触发频率限制。服务商刚重置链接、调整条目或恢复服务时，也应先确认变更已经生效，再做一次有记录的更新。不要为反复重试编造固定等待秒数；明确的等待依据应来自服务商说明或服务器响应。
- 记下更新前状态：在 Home 首页确认目标订阅名称，记录条目数量以及是否只是分组折叠。检查当前搜索或筛选是否隐藏了条目。
- 对目标执行更新：使用该订阅的更新操作。若当前界面提供下拉刷新，注意它实际覆盖的订阅范围，避免把另一组结果当成本组结果。
- 等待本次结束：不要在请求尚未完成时反复触发；保留结束提示与发生时间。
- 核对结果：重新查看同一分组。数量未变不等于失败，服务商也可能返回与此前相同的内容。
- 记录边界：更新成功只说明订阅获取与解析这一环节完成，不代表每个条目都经过连通性验证。
若只有自动更新没有发生，而手动更新可以完成，先检查相关自动更新选项与触发条件，再调查后台时机。不要把手动更新失败和后台未触发混在一次测试里，也不要把修改自动更新间隔当作服务器拒绝访问的解决办法。
第五步：用单变量测试区分网络问题
同一个订阅地址在不同网络下可能表现不同。Wi-Fi 的认证页面、DNS 解析故障、到订阅域名的连接超时或 TLS 证书问题，都可能让请求在解析内容之前失败。应先确认设备能够正常访问网络，再比较订阅请求，而不是看到空列表就直接修改服务器协议。
| 对照操作 | 记录的现象 | 下一步 |
|---|---|---|
| 保持同一地址，从 Wi-Fi 切到蜂窝网络 | 仅 Wi-Fi 更新失败 | 检查 Wi-Fi 认证、DNS 与访问限制 |
| 在另一网络重复一次相同请求 | 两边都返回相同的 401 或 403 | 优先核对凭据和服务器访问策略 |
| 核对系统日期与时间 | 出现 TLS 证书有效期相关提示 | 纠正设备时间；仍失败则让服务商核对证书 |
| 检查现有连接与自动连接条件 | 断开后立即重新连接 | 查看 Settings 设置中的 On Demand 按需连接条件 |
需要排除当前隧道影响时，先记录原状态，再到 Settings 设置 → On Demand 按需连接检查自动连接条件。临时停止相关条件后再测试，完成后恢复。不要关闭 TLS 证书验证来掩盖证书错误，这会改变连接的安全边界，却不能证明订阅内容正确。
Global Routing 全局路由中的 Proxy 代理、Direct 直连、Config 配置与 Scene 场景是流量处理选择，不是订阅修复按钮。订阅更新请求的实际路径还可能受相关设置影响，不能只看所选姿态就断言其出站方式。做对照时记录当前选项，不要同时修改 DNS、路由、订阅 URL 和服务器参数。
结论：保留可复现的一次失败
同一地址只在一种网络失败，先查网络；跨网络得到相同访问拒绝，先查服务商侧状态；请求成功但没有条目，先查响应内容。每次只改变一个条件。
五步仍未恢复：整理可提交的诊断记录
联系自己的服务商时，提供可核对的现象，比只写“更新不了”更有效。不要公开发送完整订阅地址；可先提交脱敏记录，并按对方的安全支持流程核对账户。下面这份清单既适合第一次导入为空，也适合原本正常、后来更新失败的情况。
- 故障范围：首次导入为空、更新时报错，还是列表存在但连接失败。
- 发生时间：日期、当地时间与时区；这是排查记录，不是应用更新日期。
- 操作路径：Home 首页中的目标订阅更新，或 Add Server 添加服务器中的 Subscribe 订阅导入。
- 结果依据：原始提示、可见的 HTTP 状态码、更新前后条目数量；没有看到的信息明确写“未显示”。
- 网络对照：Wi-Fi 与蜂窝网络各一次的结果，以及是否临时改变了连接状态。
- 已核对事项：链接完整性、是否重置过地址、是否等待频率限制解除，以及是否仍保留旧条目。
只有当有效订阅已经恢复、条目可以正常显示后，才进入具体连接问题的排查。需要复习导入流程，可阅读订阅手册；首次配置则按入门指南核对操作顺序。