適用於已有自有服務商與訂閱，但 Shadowrocket 無法匯入、更新後清單空白或仍顯示舊項目的情況。請先保留現有記錄，再依序釐清連結錯誤、請求失敗、回應內容不相容與清單顯示問題；每次只調整一個條件，並根據原始提示判斷下一步，避免將連線測試失敗誤認為訂閱解析失敗。
一、先區分訂閱請求、解析與連線測試
Shadowrocket（小火箭）是 Apple 平台的閉源商業應用，主要用於 iPhone / iPad，僅能透過 App Store 取得，採一次買斷制。買斷客戶端 ≠ 購買線路方案。本文以使用者已持有訂閱為前提；本站不提供、不銷售，也不推薦節點、訂閱或服務商。價格、系統需求與通用購買適用性，請以 App Store 頁面標示為準。
「訂閱更新成功」和「節點可以連線」是兩回事。更新時會先連線至訂閱網址，再解析回應中的項目；只有取得可辨識的項目後，才會進入節點連線、驗證與流量轉送階段。清單空白時直接修改節點連接埠或切換通訊協定，通常無法解決真正出問題的環節。
- 請求未完成：可能出現逾時、無法解析網域或憑證錯誤，請先檢查連線路徑。
- 回應無法解析：請求有收到內容，但可能是登入頁面、驗證頁面，或不相容的訂閱格式。
- 沒有可用項目：可能確實收到空內容，也可能是群組已摺疊、套用了搜尋條件，或更新結果取代了原有項目。
- 項目存在但測試失敗：訂閱匯入階段已建立項目，接下來應檢查對應節點的連線條件，不必再重複匯入。
二、核對完整訂閱網址，不要修改憑證
返回自有服務商的帳戶頁面，重新複製提供給 Shadowrocket 的訂閱網址。不要根據聊天記錄中被截斷的預覽、截圖文字辨識結果，或瀏覽器網址列中的帳戶頁面來推測連結。訂閱網址通常包含驗證參數，少一個字元就可能變成另一個請求。
https://example.com/sub?token=xxxx以上是假資料，不能用於實際訂閱，僅用來說明網址結構：通訊協定為 https，主機名稱為 example.com，路徑為 /sub，查詢參數包含 token。實際網址的路徑與參數由使用者的服務商決定，不必與此範例相同。
- 檢查首尾：移除誤複製的空格、換行、引號或中文句號；不要刪除網址原本包含的符號。
- 檢查參數：確認
?、&、=後方的值沒有遺漏。不要自行解碼後重新組合含有%的字串。 - 確認入口用途：帳戶登入頁、購買記錄頁和訂閱網址各不相同；單一節點的分享內容也不等於可持續更新的訂閱網址。
- 確認是否已重設：若曾在帳戶頁面重設訂閱憑證，舊網址可能立即失效；請以重新複製的網址為準。
- 保留來源：在 Home 找到對應訂閱的編輯入口，核對已儲存的 URL。先記下所屬群組與原有項目數量，再儲存修改，避免同時新增多個同名訂閱。
三、區分網路故障與伺服器拒絕
發起一次更新後，先記下完整提示，再決定要檢查網路還是帳戶狀態。以下是可能出現在回應、記錄或診斷結果中的標準 HTTP 狀態行，不代表 Shadowrocket 的每個畫面都會逐字顯示；實際判斷請以本次請求記錄為準。
錯誤：401 Unauthorized
原因：伺服器未接受目前請求的驗證資訊，憑證可能已失效。解決方式：在自有帳戶頁面確認訂閱權限並重新複製網址，不要反覆修改 token 來猜測有效值。
錯誤：403 Forbidden
原因：伺服器拒絕存取，可能與權限、存取政策或請求來源限制有關。解決方式：記錄發生時間與網路類型，向自有服務商確認限制原因；僅憑 403 無法斷定帳戶已到期。
錯誤：404 Not Found
原因：請求路徑不存在，可能是連結遭截斷、入口已變更，或伺服器以此狀態隱藏無效資源。解決方式：從帳戶頁面重新取得完整訂閱網址，再核對已儲存的 URL，不要自行猜測並補上路徑。
錯誤：429 Too Many Requests
原因：伺服器認為請求過於頻繁。解決方式：停止連續重新整理；若回應提供 Retry-After，請依指定時間等待，否則依服務商說明再試。
若發生請求逾時或網域解析錯誤，伺服器未必已收到請求。先確認目前的 Wi-Fi 是否需要網頁認證，再於允許的情況下改用行動網路測試一次。若出現憑證錯誤，應先檢查裝置日期與時間、網路認證狀態及伺服器憑證，不要關閉憑證驗證來掩蓋問題。
結論：收到拒絕回應時，先檢查權限
若已收到 401 或 403 等回應，請先核對訂閱授權與伺服器存取要求；若未收到回應，則先檢查網路路徑。不要將這兩種情況都當成需要更換節點通訊協定。
四、請求完成後，檢查回傳內容是否可解析
HTTP 請求成功只代表傳輸層已取得回應，不保證回應內容就是有效訂閱。即使伺服器回傳 200，也可能是登入頁面、互動驗證頁面、維護通知或空白文字。瀏覽器能開啟某個網址，同樣不代表 Shadowrocket 能從該網址讀取節點項目；瀏覽器可能已有登入狀態，但應用程式發出的訂閱請求未必帶有相同狀態。
| 觀察到的結果 | 代表什麼 | 下一步 |
|---|---|---|
| 回傳登入或驗證頁面 | 取得的是網頁內容，不是可直接解析的訂閱內容 | 確認使用專用訂閱入口，並請自有服務商核對介面回應 |
| 回傳空白內容 | 本次回應沒有可供解析的本文 | 核對帳戶訂閱狀態、可見項目及伺服器產生的結果 |
| 本文存在，但所有內容都解析失敗 | 可能是格式不相容、內容遭截斷或資料欄位不完整 | 使用明確適用於 Shadowrocket 的訂閱格式，並保留已遮蔽敏感資訊的錯誤資料 |
| 只顯示部分項目 | 可能有部分記錄無效，或目前畫面未顯示所有結果 | 先清除搜尋條件、展開群組，再比對伺服器預期回傳的項目 |
Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 是通訊協定名稱，不能單憑它們判斷整份訂閱文字是否有效。內容中出現這些名稱，不代表每筆記錄的驗證欄位、位址、連接埠與傳輸參數都完整。不要為了讓匯入「看起來成功」而批次修改通訊協定名稱、隨意填入連接埠，或將網頁原始碼當成節點文字貼上。
- 若帳戶頁面提供不同格式，請選擇明確標示適用於 Shadowrocket 的格式；不要只根據副檔名判斷。
- 若只有部分項目匯入，請向自有服務商說明具體缺少的範圍，不要公開完整訂閱本文。
- 若伺服器回傳的內容異常，在用戶端本機重複重新整理無法修復伺服器產生的資料。
五、回到 Home，排除顯示與更新時機問題
在 Home 先離開搜尋畫面並展開訂閱群組，確認查看的是目標訂閱，而非另一個同名群組。記下更新前的項目數量，以及是否有仍可使用的舊項目。更新失敗後舊清單仍存在，不表示已取得最新內容；清單突然空白，也不能僅憑此現象認定應用程式刪除了有效資料。
- 保留現況：記下群組名稱、更新前的項目數量、錯誤提示與本次操作時間。不要先刪除整個群組或重新安裝應用程式。
- 單獨更新：在 Home 找到目標訂閱的更新操作，手動更新一次；若操作選單因畫面配置而異，請使用目前訂閱項目提供的更新入口。
- 等待結果：等本次請求結束後再查看結果，不要連續觸發，也不要將多個群組同時更新的結果混在一起。
- 確認連線路徑：若有透過代理更新訂閱的設定，請先確認目前連線本身可用。若依賴空清單中的節點來取得這份訂閱，就會形成無法完成的依賴鏈。
- 恢復日常設定：排查期間若暫停了自動更新或變更了存取路徑，請在確認問題修復後恢復設定；記下最後成功的條件，避免下次自動更新再次失敗。
Global Routing 中的 Config、Proxy、Direct、Scene 是流量處理模式，不是訂閱格式轉換工具。訂閱請求是否透過代理，還要視應用程式相關的更新設定與目前網路路徑而定，不能只因切換至 Proxy 就認定訂閱一定會透過代理更新。Settings → On Demand 用於依條件觸發連線，不會修復失效連結，也無法解析不相容的回應。
結論：舊項目仍可用時，先保留再驗證
先修復訂閱請求或回應內容，再檢查項目是否恢復；不要刪除現有的可用項目來測試更新功能，否則可能同時失去對照資訊與可用的連線路徑。
六、常見問題與排查資料準備
若依照上述順序仍找不到原因，整理一份完整的失敗記錄，比連續嘗試更有幫助。將問題限定在「連結、請求、回應、解析、顯示」其中一個環節，可減少重複檢查，也能避免將帳戶權限問題誤交由用戶端連線設定處理。
網頁可以開啟訂閱，為什麼應用程式仍解析失敗？
先確認瀏覽器顯示的是訂閱內容，而不是登入頁或驗證頁。瀏覽器可能帶有已登入狀態；請從帳戶頁面重新複製專用訂閱網址，並請自有服務商核對未登入請求所收到的回應內容。
清單有項目，但全部逾時，還要重新匯入嗎？
先保留訂閱，在 Home 對現有項目進行連線測試，並核對伺服器狀態與節點驗證資訊。項目已顯示，代表至少有內容成功解析；連線逾時不能直接證明訂閱網址有誤。
剛更新就變成空白清單，可以連續重新整理嗎？
先停止重複請求，清除搜尋條件並展開群組，再確認帳戶頁面是否應有項目。若伺服器確實回傳空白內容或出現 429，應先處理內容問題或等待限制解除，不要持續重新整理。
換了網路就成功，需要修改所有節點嗎？
不必先批次修改。記下成功與失敗時使用的網路、是否透過代理及錯誤提示，重點檢查訂閱網域解析、網路認證與請求存取限制；節點參數和訂閱請求是不同的檢查項目。
向自有服務商回報前，請準備以下資訊
- 發生時間：註明實際日期、時間與時區，方便比對伺服器請求記錄。
- 操作位置：註明是首次匯入，還是在 Home 更新既有訂閱，以及故障前後的項目數量。
- 原始提示：保留完整錯誤文字或狀態碼，不要只描述「不能用」；截圖時遮蔽憑證、QR Code 與個人資訊。
- 對照結果：註明 Wi-Fi 與行動網路的結果是否不同、是否只有某一份既有訂閱失敗，以及是否變更過更新路徑。
- 用戶端環境：提供裝置、系統與應用程式中實際顯示的版本資訊，不要猜測版本，也不要為了排查而先清除本機設定。
排查完成的標準是：目標訂閱請求成功、回應可解析、Home 顯示預期項目，接著再單獨確認節點連線結果。不要只以錯誤提示消失作為恢復依據，也不要將一次更新成功解讀為之後所有線路都一定可用。