适用于已在 Shadowrocket（小火箭）导入自己订阅的 iPhone、iPad 用户。本文说明 Home 中的手动刷新、Settings → Subscribe 中的打开应用时更新设置，以及更新失败时如何区分链接失效、请求不通和内容无法解析；判断依据是刷新结果，不是连接开关的状态。
先确认：失败的是获取订阅，还是使用现有配置
订阅更新是一条独立流程：Shadowrocket 请求已保存的订阅地址，接收返回内容，解析后更新 Home 中的条目。Home 里还能看到原有条目，只能说明设备上保留着上一次成功导入的数据，不能证明本次请求成功。反过来，更新失败也不必然表示所有现有连接立即失效；两件事需要分别检查。
排查前先记下失败的是哪一组订阅，以及刷新时的提示原文。若有多个订阅，逐组操作，不要凭某一组的结果判断全部链接。再观察刷新前后条目数量和更新时间是否变化：提示消失但内容没有变化，可能只是服务商返回了相同数据；出现错误且旧条目仍在，则本次更新没有产生可用的新内容。
判断顺序：先核对刷新结果
先确认是哪一个订阅、出现了什么提示、旧条目是否仍在，再检查连接状态。不要通过反复切换 Home 的连接开关来代替订阅更新测试。
手动更新：逐组刷新并核对保存的地址
手动更新适合首次定位问题，因为每操作一组就能立即观察结果。以下步骤以用户已经持有自己的订阅链接为前提；示意地址 https://example.com/sub?token=xxxx 仅用于说明链接结构，不是可用订阅。更新时应使用自己已保存的实际地址，并核对它是否完整。
找到订阅
打开 Shadowrocket 的 Home，找到此前导入的 Subscribe 条目。若 Home 中有多个分组，先确定本次需要更新的那一组，避免把另一组的成功结果当作故障已解决。
手动刷新
在 Home 对订阅执行下拉刷新，等待请求结束；不要在提示尚未出现时连续重复操作。记录屏幕显示的错误文字，并比较刷新前后的条目。
核对链接
进入该订阅的编辑页面，检查 Type 是否为 Subscribe，并核对保存的 URL。重点查看域名、路径与
token等查询参数有无缺失、过期或多余空格；核对后保存，再回 Home 刷新一次。记录结果
如果只有这一组失败，优先检查它的链接与返回内容；如果所有订阅都超时，优先检查当前网络。保留错误原文，便于向自己的服务商确认链接状态。
尚未导入订阅时，Home 右上角「+」→ Type 选择 Subscribe，填入用户已有的链接并保存，然后再进行第一次刷新。复制链接时要包含问号后的完整参数：例如示意地址里的 ?token=xxxx 是 URL 的一部分，漏掉后可能返回拒绝访问或与预期不同的内容。不要将真实链接及其中的凭据公开发布。
打开应用时自动更新：设置与适用条件
打开应用时更新的作用，是在进入 Shadowrocket 时尝试获取订阅的新内容；它不是后台持续刷新，也不能修复无效地址。先完成一次手动更新并确认成功，再到 Settings → Subscribe 查看打开应用时更新的选项。若当前界面提供 Update on Open，按需要启用；具体可见选项以应用内页面为准。
先验证链接
回到 Home 手动刷新目标订阅，确认没有错误提示，并检查订阅内容能正常显示。手动更新失败时，先按下文三类原因排查，不要仅通过开启自动更新反复重试。
查看设置
进入 Settings → Subscribe，查看 Update on Open 等与打开应用时更新有关的选项。调整后返回 Home；若管理多组订阅，还要留意每组各自的刷新结果。
再次核对
下次打开应用后，等待网络请求完成，再比较订阅内容或查看更新提示。应用被打开，不等于远端一定返回了新条目；服务商内容未改变时，列表可能保持原样。
如果只有通过现有代理连接才能访问自己的订阅地址，可在 Settings → Subscribe 检查 Update via Proxy，并结合当前连接是否可用来测试。该选项改变的是更新请求所走的网络路径，不会替换失效链接，也不会把无法解析的响应变成订阅。测试时一次只调整一个条件：先尝试当前路径，再切换该选项并手动刷新，比较两次结果。
设置原则：自动更新建立在手动成功之上
手动刷新已经确认能获取并解析内容后，再启用打开应用时更新；若手动失败，保留错误提示，逐项排查链接、网络和格式。
更新失败的三类原因与对应处理
错误文案会随请求阶段与服务器响应而不同。下列卡片中的英文或状态码是可能见到的提示示例，应以设备上实际显示的内容为准。同一个 “Failed to load subscription” 也可能由多种原因触发，因此不能只凭一句提示断定链接过期。
报错:HTTP 403
原因与解法:服务器拒绝当前请求，可能与链接凭据或访问限制有关。核对订阅 URL 中的完整参数，向自己的服务商确认访问条件；不要自行猜测或更改凭据。
报错:HTTP 404
原因与解法:请求地址没有对应资源。核对域名及路径是否与自己保存的地址一致；如果原地址已调整，向自己的服务商确认新的有效地址后再更新。
报错:The request timed out.
原因与解法:请求在等待时间内没有完成。先确认当前 Wi-Fi 或 Cellular 能正常访问网络，再比较直连与 Settings → Subscribe → Update via Proxy 下的手动刷新结果。
报错:Failed to load subscription
原因与解法:应用未能取得或使用本次订阅内容。先检查链接和网络；若请求能完成但仍没有可用条目，请自己的服务商核对响应内容是否为可解析的订阅格式。
链接失效：先查地址，再查授权
只有一组订阅失败，尤其是保存链接近期发生过变更时，先核对 URL。域名拼写、路径末尾及查询参数都可能影响服务器返回结果。HTTP 403 更适合从访问条件入手，HTTP 404 则先查路径；但服务器也可能用其他状态表达同一问题。不要删除仍可用的旧条目来测试链接，先保留现场并向自己的服务商确认。
网络不通：区分设备联网与订阅请求路径
Wi-Fi 或 Cellular 显示已连接，不代表订阅地址必然可达。先确认设备可以正常访问网络，然后在相同网络环境下重试 Home 的手动刷新。如果所有订阅都超时，检查当前网络；如果仅特定地址超时，再核对该地址的访问条件。调整 Update via Proxy 前，应确认所选连接本身可用，否则更新请求仍可能失败。
格式无法解析：看响应内容，不看文件名
请求成功到达服务器，仍可能收到登录页、错误说明或空白内容，而不是 Shadowrocket 能解析的订阅数据。表现可能是刷新后没有新增条目，也可能是载入失败。此时反复切换 Global Routing 的 Proxy、Direct 或 Config 不能修复服务器返回的内容；应核对 Type 为 Subscribe，并请自己的服务商检查该链接的实际响应格式。
常见追问：刷新后仍看不到预期变化
下拉刷新没有报错，条目却没变？
先确认刷新的确是目标订阅，而不是列表中的另一组。再比较服务商当前提供的内容：远端条目未变化时，刷新成功也不会让列表凭空增加项目。不要仅以数量不变判断失败。
打开应用时更新已开启，为什么还要手动试？
手动刷新能把一次操作与一次结果对应起来。返回 Home 对目标订阅下拉刷新，记录错误原文；若仍失败，依次检查链接、网络路径和返回内容，而不是等待下一次打开应用。
开启 Update via Proxy 后还是超时？
先确认 Home 当前选择的连接可用，再检查 Settings → Subscribe 中该选项的状态。若两种请求路径都超时，保留时间和错误提示，向自己的服务商核对订阅地址的访问条件。
能打开链接，却仍提示载入失败？
能收到网页不等于收到可解析的订阅。检查 Type 是否为 Subscribe、URL 是否完整，并请自己的服务商核对该地址返回的内容；登录页面或错误页面不能作为订阅条目导入。
更新失败会删除原来的条目吗？
先在 Home 检查现有条目是否仍显示，不要假定本次失败已改写全部配置。记录刷新前后的实际变化，在确认新链接可用前，避免通过删除旧订阅来排查。
排查完成后，可以重新执行一次手动刷新，确认目标订阅能够正常返回内容，再观察下次打开应用时的更新结果。订阅由用户自己的服务商提供；Shadowrocket 是用于导入和使用这些配置的 Apple 平台付费客户端，客户端买断 ≠ 线路套餐。iPhone、iPad 的系统要求以 App Store 页面标注为准。