Shadowrocket 订阅添加失败怎么办？按报错逐步排查
简答：Shadowrocket 订阅添加失败，先确认使用的是完整 HTTPS 订阅链接，并在 Home 的“+”中选择 Subscribe。随后按保存失败、更新超时、解析失败、节点为空或节点无法连接分别检查链接、网络、系统时间和订阅状态。
定义：Shadowrocket 订阅添加失败，是指订阅链接无法保存、无法更新、返回内容不能解析，或更新后没有出现可用节点。
先按现象判断：不要把订阅导入和节点连接混在一起
本文与 Shadowrocket 项目及开发者无隶属关系。Shadowrocket 是用于导入配置、匹配规则并连接代理服务器的客户端；App Store 页面明确说明它本身不提供代理服务或服务器资源，使用者需要准备自己的配置。可参考 Shadowrocket App Store 页面。
| 你看到的现象 | 优先检查 | 判定标准 |
|---|---|---|
| 点保存就失败或没有新增条目 | Type、URL 完整性、空格和换行 | 能保存一条订阅记录，才进入下一步 |
| 有订阅记录，但更新超时或请求失败 | Wi-Fi、蜂窝数据、域名和服务端响应 | 更新动作结束且没有超时或网络错误 |
| 更新成功，但节点列表为空 | 返回格式、订阅权限、套餐或流量状态 | 列表中出现一个或多个节点名称 |
| 节点出现，但无法连接 | 节点本身、规则、DNS、网络和权限 | 至少一个节点完成连接并能访问测试地址 |
最快的第一步是重新复制订阅链接，并确认从链接开头到结尾都被复制。不要把链接中的 https://、问号、&、等号、token 参数、大小写字符或路径截断；也不要把说明文字、引号、空格或换行一起粘贴进去。
正确添加订阅：选择 Subscribe，不要把订阅 URL 当成单节点
- 打开 Shadowrocket，进入 Home，点击右上角的“+”或添加按钮。
- 在 Type 中选择 Subscribe。订阅 URL 通常对应一组节点；如果你拿到的是单个服务器地址、端口、密码、UUID 或密钥，应按对方提供的协议选择单节点类型，不能猜测。
- 把完整订阅地址粘贴到 URL 字段。示例中的
https://example.com/sub?token=xxxx仅表示格式，必须替换为你自己的真实地址，不要直接使用示例域名。 - 填写便于识别的备注并保存，然后回到订阅条目执行更新。如果保存后没有节点，不要立即修改规则、DNS 或测速设置，先确认更新请求是否成功。
App Store 资料确认 Shadowrocket支持从 URL 或 iCloud Drive 导入规则文件，并支持多种网络协议；但这不等于任意 URL 都能作为订阅使用。Clash、sing-box 或其他客户端的配置文件可能是不同格式，是否能被当前版本解析需要以返回内容和客户端支持情况为准，未核实的格式不要强行导入。参考 App Store 功能说明。
如果你不确定复制是否完整，可以先把链接粘贴到备忘录中检查：是否只有一行、是否以明确的协议头开头、是否包含原本的查询参数。不要把带 token、密码或账户标识的完整订阅链接发到公开群组、论坛或截图中；如需求助，只向原服务商的正规客服提供必要信息。
更新失败、超时或解析失败：按网络和返回内容排查
- 先切换网络。在 iPhone 上依次测试当前 Wi-Fi、蜂窝数据，或换一个可信网络。Apple 说明，iPhone 可以使用 Wi-Fi 或蜂窝网络连接互联网；蜂窝数据可在“设置→蜂窝网络”中管理，具体可参考 Apple 关于蜂窝数据设置的说明。
- 确认 Shadowrocket 获得蜂窝数据权限。如果 Wi-Fi 下失败、蜂窝数据下成功，问题更可能在当前 Wi-Fi、DNS、网关或网络策略，而不是订阅文本本身。
- 用 Safari 检查地址是否能返回内容。浏览器能打开不代表 Shadowrocket一定能解析，但可以帮助区分“域名完全不可达”和“返回格式不兼容”。如果显示登录页、验证码页、站点首页或 HTML 错误页，说明这个地址未返回预期订阅内容；如果提示 403、404、过期或服务不可用，应联系原服务商核实权限、域名和链接状态。
- 遇到 SSL、证书或安全连接错误时检查日期时间。进入“设置→通用→日期与时间”，打开“自动设置”。Apple 的说明见 如果无法更改 Apple 设备日期或时间。系统时间明显错误时，证书校验可能出现异常；修正后重新打开客户端再试。
判断重点不是“浏览器有没有显示一段文字”，而是返回结果是否属于客户端能够识别的订阅内容。HTML 页面、登录页面、下载错误页和空白响应都不能证明订阅有效。对于需要登录、额外 Cookie 或特殊请求头的地址，Shadowrocket 是否支持要以当前客户端能力和服务商说明为准，无法核实的情况不要继续反复改设置。
保存成功但节点为空：检查订阅状态和格式边界
如果订阅条目已经保存，更新也没有明显报错，但列表仍为空，优先排查以下项目：
- 订阅是否已经过期，套餐是否仍有效，流量是否已经用完。
- 服务商是否更换了订阅域名、路径或 token，旧链接是否被重置。
- 复制时是否遗漏查询参数，尤其是问号后的内容；删掉参数可能导致权限校验失败。
- 返回内容是否为 Shadowrocket 当前可识别的订阅格式，而不是仅供 Clash、sing-box 或其他工具使用的配置文件。
- 服务端是否根据设备、IP、请求头或登录状态限制访问；这类限制通常无法仅靠客户端按钮修复。
可以把结果分成两种：如果 Safari 访问也失败，优先联系原服务商核验订阅有效期、域名和权限；如果 Safari 能访问但 Shadowrocket 仍为空，提供给客服的应是错误时间、网络类型、客户端提示和脱敏后的 URL 结构，不要公开完整 token。不要因为列表为空就反复删除所有配置，先保留原条目并记录每次更新结果。
节点已经出现但无法连接：到这里才排查连接层
节点列表出现，说明“订阅下载和初步解析”至少完成了一部分，但不代表远端节点一定可用。此时先选择一个节点，使用客户端提供的连接或测试功能观察结果，再逐项检查：
- 确认已选择实际节点，而不是空的策略组或未配置的默认项。
- 检查 Shadowrocket 的连接开关和 iOS 的 VPN 配置授权是否已完成；如果系统没有出现授权提示，可先关闭客户端后重新打开并发起一次连接。
- 暂时不要同时修改规则、DNS、脚本和重写设置。先使用最简单的路由模式验证一个节点，避免多个变量同时变化。
- 如果一个节点失败，换同一订阅中的另一个节点；如果全部节点失败，更应检查订阅状态、网络可达性或服务商端，而不是只修改本机规则。
- 如果只有某些网站打不开，再检查规则模式、DNS 或目标站点本身；这已经属于连接与路由问题，不再是“订阅添加失败”。
Shadowrocket 的 App Store 资料列出了 DNS、规则、流量和网络测试等功能，但没有承诺任何外部节点或线路一定可用；因此“订阅能导入”和“节点能连接”必须分别验证。
什么时候停止自行修改，直接联系原服务商
出现以下情况时，继续反复粘贴或改客户端设置通常意义不大：订阅链接在多个网络都返回 403、404、过期或服务不可用；服务商明确更换了域名或重置了 token；账户套餐或流量状态无法在客户端确认；Safari 能访问但返回的是登录页、HTML 页面或空响应；同一订阅中的所有节点都消失。
联系客服时建议提供：设备系统版本、Shadowrocket 的安装来源、失败发生的准确时间、使用 Wi-Fi 还是蜂窝数据、客户端显示的原始错误文字，以及经过遮挡的链接结构。不要提供完整 token、密码、UUID 或账户凭据。若客服确认订阅已恢复，再重新复制完整链接并只执行一次更新，便于判断结果。
常见问题
Shadowrocket 添加订阅时应该选择哪一种类型？
如果拿到的是一条用于获取多个节点的订阅 URL，通常应在 Home 的添加入口中选择 Subscribe；如果只有一个节点的地址、端口、密码或 UUID，应按对应协议添加单节点。具体名称可能随版本变化，无法确认时以服务商提供的导入方式为准。
为什么浏览器能打开订阅链接，Shadowrocket 仍然导入失败？
浏览器只能证明地址返回了某些内容，不能证明返回内容是 Shadowrocket 可解析的订阅格式。若浏览器显示登录页、HTML 页面、验证码、错误页或空内容，客户端可能无法导入；还要检查链接是否需要 Cookie、特殊请求头或权限。
Shadowrocket 更新成功但节点列表为空怎么办？
先确认套餐有效期、流量和订阅权限，再核对域名、路径、token 参数是否完整；随后确认返回内容是否属于当前客户端支持的订阅格式。若多个网络都为空，应联系原服务商核验，不要公开完整订阅链接。
提示 SSL 或证书错误，应该先改 DNS 吗？
不建议先改 DNS。先检查 iPhone 的“设置→通用→日期与时间”是否开启自动设置，再切换网络重试。若仍提示证书或服务端错误，应让原服务商检查域名和证书状态。
订阅导入成功但所有节点都连不上，是订阅添加失败吗？
不是同一个问题。节点已经出现，说明导入阶段完成；接下来要检查节点本身、网络、VPN 权限、路由模式和 DNS。若同一订阅中的全部节点都失败，再回到订阅有效期、域名和服务端状态排查。