先保留現有訂閱，再依「連結、連線、回應內容、帳戶狀態、更新時機」的順序檢查，不要一開始就刪除所有節點。本文適用於已有自己服務商與訂閱的 Shadowrocket 使用者；操作以 iPhone / iPad 的 Home 為例，Mac、Windows、Android、Linux 也可依相同順序排查，實際控制項位置請以目前平台介面為準。
一、先分辨解析失敗、清單空白與連線失敗
Shadowrocket（小火箭）更新訂閱時，會先取得遠端內容，再從中讀取節點參數。要求逾時、收到登入網頁、取得空白內容，以及無法辨識節點參數，分別發生在不同階段。只看到「更新未成功」無法判定原因，也不能據此認定原有節點是否可用。
| 目前現象 | 優先檢查 | 暫時不要做 |
|---|---|---|
| 更新提示逾時，舊節點仍在 | 目前網路能否連上訂閱網址 | 刪除仍可使用的舊訂閱 |
| 收到回應後提示解析失敗 | 回傳的是訂閱資料，還是網頁、錯誤頁面 | 任意修改 UUID、密碼或協定類型 |
| 訂閱群組存在，但沒有節點 | 服務商端的節點指派、回應內容、清單篩選 | 直接把空白清單當成本機設定損毀 |
| 節點已顯示，但連線失敗 | 節點參數、網路與連線測試結果 | 反覆匯入相同訂閱來取代連線診斷 |
先在 Home 確認目前檢視的是目標訂閱群組，清除搜尋條件並展開摺疊群組。如果看得到節點名稱，表示至少已有節點資料，不應再當作「清單空白」處理。Config 中的規則設定與 Home 中的節點訂閱用途不同，新增規則設定檔無法取代匯入節點訂閱。
二、核對訂閱連結：確認網址完整，比重新匯入更重要
請從自己服務商的帳戶頁面重新複製適用於 Shadowrocket 的訂閱網址，再逐項比對已儲存的網址。不要複製瀏覽器網址列中的帳戶首頁，也不要把網頁上的說明文字、按鈕名稱或登入重新導向網址當成訂閱。以下僅展示網址結構，無法用於實際匯入。
https://example.com/sub?token=xxxx- 核對開頭。確認通訊協定部分完整，例如
https://，不要漏掉冒號或斜線。連結前後不應附帶引號、中文括號或說明文字。 - 核對結尾。確認
?後的查詢參數完整無缺。訊息預覽中的省略號並非網址的一部分；從預覽卡片抄寫時容易漏掉 token。 - 保留參數原樣。
&用來分隔查詢參數，%2F等則是編碼片段。請勿自行解碼、調整順序或刪除看似多餘的字元。 - 檢查複製來源。優先使用帳戶頁面提供的複製功能。若貼上後出現換行，請重新複製並核對；不要把螢幕自動換行誤認為實際換行。
- 確認連結用途。單一節點分享內容、規則設定連結與訂閱網址並非同一種輸入。請依服務商標示的用途匯入，不要只憑副檔名判斷。
如果服務商已重設訂閱憑證，舊網址即使格式正確也可能失效。請更新本機訂閱網址，而不是只修改訂閱顯示名稱。不要為了排查而頻繁重設 token：這可能同時影響使用相同網址的其他裝置。
三、依回應結果分辨連線問題與內容問題
「瀏覽器能開啟」只能表示瀏覽器收到某種回應，不代表 Shadowrocket 能解析該回應。瀏覽器可能帶有已登入的 Cookie，但訂閱要求不能依賴瀏覽器的登入狀態。即使登入頁、驗證碼頁或維護通知成功顯示，也不是節點資料。
以下列出可能出現在回應或診斷資訊中的標準 HTTP 狀態，不代表各平台都會以相同文字顯示彈出訊息。只有實際看到相應狀態時才依該項處理；不要從「清單空白」反推伺服器一定回傳了某個狀態碼。
HTTP 401 Unauthorized
原因與處理方式：要求缺少有效的身分憑證，可能與 token 失效有關；請回到帳戶頁面重新核對訂閱網址，並向自己的服務商確認憑證狀態。
HTTP 403 Forbidden
原因與處理方式：伺服器拒絕存取，可能與存取政策或帳戶權限有關；請記下發生時間與使用的網路，交由服務商確認，不要試圖修改節點密碼來解決。
HTTP 404 Not Found
原因與處理方式：目標路徑不存在或未提供該資源；請重新複製目前帳戶頁面提供的網址，並檢查路徑是否遭截斷或已變更。
HTTP 429 Too Many Requests
原因與處理方式：要求頻率受到限制；請停止連續重新整理，依服務商說明或回應中的 Retry-After 等待，再執行一次更新。
HTTP 200 也不保證解析成功：回應內容可能是 HTML 錯誤說明，或是空白本文。若能查看回應，請確認內容是否為服務商提供的用戶端訂閱資料；不要將整頁 HTML 複製到 Add Server。即使看到編碼文字，也不要隨意解碼後覆寫原訂閱，應先確認匯出格式。
結論：先確認收到的內容，再調整用戶端
若同一網址回傳登入頁、維護頁或空白內容，下一步應向自己的服務商確認訂閱介面；此時切換 Global Routing 或修改 Config 規則，無法把網頁轉成節點資料。
四、服務商端自查：到期、流量配額與節點指派
帳戶可以登入與訂閱可用是兩回事。服務有效期限、流量配額、帳戶狀態和節點指派都可能影響訂閱內容。各家服務商的處理方式不同：有的會回傳空白清單，有的會回傳說明資訊，有的則直接拒絕要求，不能只憑單一提示就判定帳戶已到期。
- 有效期限：確認服務權益是否仍有效，不要只看帳戶註冊狀態。剛完成續期時，請確認帳戶頁面是否已顯示生效。
- 流量配額：確認目前週期是否還有可用流量，以及是否正在等待重設。實際恢復時間請以自己的服務商說明為準。
- 指派狀態：確認目前帳戶確實已指派節點，並檢查是否啟用了會排除所有節點的匯出篩選條件。
- 匯出格式：若帳戶頁面提供用戶端格式選項，請使用其標示適用於 Shadowrocket 的格式；不要將其他用途的設定檔改名後匯入。
- 維護狀態：查看帳戶頁面中的維護資訊。介面暫時故障不代表需要重新安裝 Shadowrocket。
Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 是不同的協定，訂閱中的參數必須與相應協定相符。解析失敗時，不要為了「先顯示出來」就強行改成另一種協定。請服務商確認匯出內容與用戶端相容，比手動猜測連接埠、TLS 或驗證欄位更可靠。
五、更新時機與網路：每次只變更一項條件
續期、重設連結或修改節點指派後，上游系統可能尚未完成同步。沒有適用於所有服務商的固定等待秒數，請以帳戶頁面狀態和服務商說明為準。連續重新整理不會加快同步，還可能觸發頻率限制，讓原有問題和新產生的限流混在一起。
- 記錄目前狀態。記下更新時間、完整錯誤訊息、節點是否仍存在，以及當時使用 Wi-Fi 還是行動網路。不要先清除仍可用的內容。
- 完成網路連線。如果 Wi-Fi 需要網頁認證，請先完成認證，再回到 Home 更新訂閱。認證網頁可能導致訂閱要求收到非預期內容。
- 手動更新一次。在 Home 對目標訂閱執行更新，可透過下拉重新整理觸發檢查；確認目標群組是否更新，不要只看連線開關。
- 切換網路再試一次。條件允許時，可從 Wi-Fi 切換到行動網路，或反向切換。保持訂閱網址不變，方便判斷問題是否與網路有關。
- 依結果判斷方向。只有某個網路失敗時，優先檢查該網路的存取條件；不同網路都回傳相同的權限或內容錯誤時，優先聯絡自己的服務商。
不要把「必須先開啟連線才能更新」當成通用步驟。訂閱要求能否送達，取決於網路與相關設定；如果目前節點已無法使用，依賴該節點存取訂閱反而可能形成循環。Global Routing 中的 Config、Proxy、Direct、Scene 是路由模式，不是修復訂閱格式的選項。若要測試路由條件，每次只變更一項設定，記錄原值，測試後再還原。
Settings → On Demand 用來控制是否依條件連線，並不會產生訂閱內容。為了排查清單空白而反覆切換 On Demand，只會增加變數；請保留原設定，先檢查連結與回應。自動更新也無法修復已失效的 token；手動更新確認成功後，再觀察後續自動更新結果。
六、常見問題與回報清單
瀏覽器能開啟訂閱，為什麼仍然解析失敗？
先確認顯示的是訂閱資料，而不是登入網頁或通知頁。瀏覽器的登入狀態可能掩蓋介面權限問題；請從自己的帳戶頁面重新複製用戶端訂閱網址，再於 Home 更新一次。
剛續期，為什麼節點仍是空白？
先確認帳戶頁面是否已顯示權益生效並完成節點指派，再依服務商說明等待同步。等待期間不要重複新增多個相同訂閱，否則之後難以分辨更新的是哪個群組。
其他裝置有節點，這台沒有，需要重新安裝嗎？
先核對兩台裝置的訂閱網址、更新時間與搜尋篩選條件。另一台顯示的可能是舊快取，不能據此證明目前介面正常；請讓兩台裝置分別更新並記錄結果，再判斷裝置間的差異。
重新匯入前，需要刪除舊訂閱嗎？
請先保留舊訂閱及仍可使用的節點。若確實需要測試新網址，請使用容易區分的新名稱並核對更新結果；確認新訂閱正常，且沒有需要保留的本機修改後，再整理重複項目。
如果仍找不到原因，請向自己的服務商提交不含憑證的紀錄。能協助重現問題的資訊，比「不能用了」更有用，也能減少來回確認。請勿附上完整訂閱 QR Code 或可辨識個人帳戶的截圖。
- 裝置與作業系統類型，以及問題發生於 Wi-Fi、行動網路或兩者皆有。
- 問題發生時間與時區，以及上一次成功更新的大約時間。
- 錯誤原文或實際 HTTP 狀態，以及是否收到網頁或空白內容。
- 帳戶權益是否生效、是否曾修改 token，以及是否變更過匯出格式。
- 已執行的操作及各自結果，例如「同一網址切換網路後仍回傳 403」。