Shadowrocket 订阅解析失败或节点为空:链接格式、服务商侧与更新时机自查

一、先分清订阅失败与节点连接失败

Shadowrocket（小火箭）是 Apple 平台的付费客户端，唯一获取入口是 App Store，开发者为 Shadow Launch Technology Limited，采用一次性买断。应用购买不等于取得连接服务，本文全程以用户已有自己的服务商与订阅为前提。兼容设备与系统要求以 App Store 页面标注为准。

订阅更新的目标是取得并解析服务器信息，不是验证每个服务器都能建立连接。Home 中完全没有条目，与列表存在但连接超时，是两个不同问题。前者先检查订阅地址及返回内容；后者才进入服务器地址、端口、认证参数与网络可达性的排查。

处理链任一环节异常，都可能表现为更新失败或列表没有新增条目。HTTP 请求成功只说明服务器返回了内容，并不保证该内容就是可解析的订阅；反过来，旧条目仍在也不能证明本次更新已经成功。

• 首次添加即为空：重点核对粘贴地址、订阅格式和服务商实际返回的条目数量。
• 原来正常，更新后异常：重点核对凭据是否被重置、订阅资格是否变化，以及服务商接口是否维护。
• 条目存在但无法连接：先停止反复更新，转而检查具体服务器的连接错误。

二、核对完整链接，避免手工改坏编码

从自己的服务商账户页面复制供 Shadowrocket 使用的订阅地址，不要复制账户首页、订单页面或按钮显示的短标题。订阅地址通常包含身份凭据；看起来相似的两个地址，可能分别返回账户页面和服务器数据，作用并不相同。

https://example.com/sub?token=xxxx

上面只是不可用的格式示例。核对真实地址时，要检查从 https:// 到最后一个字符是否完整，尤其是 ? 后的查询参数。通过聊天消息转发时，末尾标点、换行和截断容易被误带入；应重新从原始入口复制，而不是凭记忆补齐。

• 检查空白：地址首尾不应包含空格，地址中不应混入真实换行。文本框自动折行本身不等于地址被插入换行。
• 保留大小写：域名之外的路径、参数名和凭据可能区分大小写，不能统一转换。
• 保留编码：%2B、%2F、%3D 可能是凭据的一部分，不要手动解码，也不要再次编码。
• 识别网页转义：网页源码中的 & 不是应当直接粘贴的参数分隔符；优先使用服务商提供的复制功能。
• 分清地址类型：单个服务器分享内容与订阅 URL 不是同一类输入，不应把所有内容都按 Subscribe 添加。

三、按界面路径重新验证一次导入

Shadowrocket 的 Home 用于查看与管理服务器，Config 用于配置文件，Settings 用于应用设置。订阅地址应在 Home 中作为 Subscribe 添加；把它当作 Config 文件导入，并不能替代服务器订阅的解析。验证前先记录旧订阅名称、当前条目数量和错误信息，不要先清空全部内容。

1. 保留旧条目

   在 Home 确认原订阅与已有条目仍在。若当前连接依赖这些条目，先保留原状态，不以删除后重建作为第一步。

2. 选择 Subscribe

   进入 Home，点右上角“+”，在 Type 中选择 Subscribe。填写可辨认的名称，将自己复制的完整订阅地址粘贴到 URL 字段。

3. 保存并更新

   保存后返回 Home，下拉触发更新，等待此次请求结束。记录成功、失败或条目数量变化，不要在请求尚未结束时连续刷新。

4. 检查列表显示

   清除 Home 中的搜索条件，并展开对应订阅分组，确认不是筛选或折叠造成的“空列表”。名称没变化时，也要对照条目数量判断。

5. 区分后续故障

   若服务器项已经出现，订阅解析环节已取得结果。接下来单独验证连接，不再把连接超时归为“订阅为空”。

若只是现有订阅地址被服务商重置，应修改对应订阅保存的 URL，而不是长期保留多个同名分组。并行测试确有必要时，给测试项使用清楚的名称，测试结束后再清理，避免把旧列表当成新结果。

四、结合 HTTP 状态与返回内容定位原因

能看到请求详情时，先记录状态码，再确认响应内容。以下是标准 HTTP 状态描述，不保证 Shadowrocket 在所有场景下逐字显示；只有实际错误详情或服务商记录出现对应状态，才按该项处理。不要为了取得状态码而把完整凭据提交到第三方网站。

即使正文非空，也可能只有提示文字、空的数据集合，或不是当前入口支持的格式。Base64 只是编码方式，不代表其中一定包含有效服务器信息；不要自行给全文补字符、反复解码或拼接协议前缀。应让自己的服务商确认返回格式与实际有效条目数量。

五、向自己的服务商核对资格与返回格式

账户可以登录，并不等于订阅接口当前一定返回服务器。订阅资格、流量状态、有效期、服务维护和凭据重置都可能影响接口结果。付款或续期后，也应先确认账户侧已经生效，而不是用重复刷新代替核对。

• 确认资格：账户中相应服务是否有效，是否存在流量限制、暂停状态或尚未完成的状态同步。
• 确认凭据：最近是否重置过订阅链接，Home 保存的是否仍为旧 token。
• 确认正文：接口返回的是服务器数据，还是登录页面、验证页面、错误说明或零条目结果。
• 确认格式：取得适用于 Shadowrocket 的现有订阅格式。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 是协议名称，不应只修改名称就视为完成格式转换。
• 确认变更：接口域名、路径、证书或响应格式是否发生过调整，服务商是否需要修复生成结果。

反馈时提供错误原文、发生时间与时区、所用网络、是否首次添加，以及“旧条目是否保留、更新前后数量是否变化”。这些信息比单独描述“不能用”更容易定位。截图前遮盖完整订阅 URL、token、服务器密码和其他认证内容；需要核查账户时使用自己的服务商私密支持渠道。

六、排除网络与更新时机干扰，再做最终复测

订阅获取本身也需要网络。域名解析失败、TLS 证书异常、连接超时或需要网页登录的 Wi-Fi，都可能使请求无法取得正文。先确认设备日期与时间正确，当前网络已完成必要的登录，再进行一次更新。遇到证书错误时应核对设备时间并让服务商检查证书，不以关闭安全校验作为解决方法。

Global Routing 决定连接流量的处理方式，不负责修补错误的订阅格式；Settings → On Demand 控制按需连接行为，也不是订阅更新开关。若测试需要暂时停止连接，应先记录原设置，并检查 On Demand 是否会重新建立连接。排查完成后恢复原状态。

1. 固定输入：使用刚核对过的同一订阅地址，记录当前时间与 Home 中的条目数量。
2. 完成一次请求：在当前网络更新一次，等待明确结果。不要同时修改地址、连接姿态和网络，否则难以判断哪项产生影响。
3. 单独更换网络：在条件允许时，从 Wi-Fi 切到蜂窝网络或反向切换，再测试一次。仅某个网络失败时，优先检查该网络的解析与访问条件。
4. 避开频率限制：已出现请求受限或服务维护提示时，按服务商给出的时间再试，不设置密集自动更新。
5. 验收结果：确认订阅分组中出现预期条目，再单独测试服务器连接。若仍为空，携带两次测试的时间与错误结果联系自己的服务商。

最终应能把问题归入明确环节：地址不完整、请求未到达、访问被拒绝、正文格式不符或服务器连接异常。按这个顺序处理，可以保留仍可用的配置，也能避免把服务商返回内容的问题误当作客户端安装问题。