Shadowrocket 訂閱匯入後顯示空白或解析失敗：連結格式、服務商狀態與更新時機排查

先釐清：訂閱空白、解析失敗與連線失敗

Shadowrocket 更新訂閱時，會從既有訂閱網址取得內容並產生項目；連線測試則是使用某個項目建立連線。前者成功不代表後者一定成功，後者失敗也不能證明訂閱網址無效。排查時先確認問題發生在哪個步驟，不要把所有狀況都歸因於「節點不能用」。

• 儲存後只有訂閱群組，沒有項目：確認是否已執行更新、群組是否展開，以及回應內容是否確實包含有效項目。
• 更新時出現解析提示：優先確認回應格式。登入頁面、錯誤訊息與空白內容都無法當成正常訂閱清單解析。
• 更新等待很久後失敗：優先檢查連線至訂閱網域的網路、DNS 與 TLS 連線，再確認伺服器是否正常。
• 已出現項目，但無法連線：改為檢查個別項目的網址、連接埠、驗證資訊與傳輸參數，不要繼續用重新整理訂閱代替連線診斷。

Home 主要用於管理項目與連線，Config 用於設定檔，Settings 用於相關設定。修改 Config 中的 DOMAIN-SUFFIX 或 FINAL，無法將登入網頁轉換成訂閱內容。請先保留現有設定，只針對訂閱本身進行必要檢查，方便判斷每次操作是否有效。

連結格式：從 Subscribe 入口確認完整網址

從自己服務商的訂閱管理頁面重新複製網址，比手動修補不完整的連結可靠。請確認複製的是訂閱網址，而不是帳戶首頁、登入網址或帳單頁面。訂閱 URL 中的查詢參數通常用於驗證，少一個字元也可能改變伺服器回傳的結果。

1. 保留原有記錄

   在 Home 記下目前的訂閱名稱、既有項目數量與這次的失敗提示。暫時不要刪除仍有可用項目的訂閱，也不要覆蓋既有 Config。

2. 複製完整網址

   在自己的服務商頁面複製完整訂閱 URL，檢查開頭的通訊協定、網域、路徑，以及問號後的所有參數。移除複製時帶入的前後空白，不要任意修改參數。

3. 確認輸入類型

   需要新增時，請在 Home 右上角點選「+」進入 Add Server，將 Type 設為 Subscribe，再將網址貼到 URL。若已有訂閱，請進入對應的編輯頁確認 URL，避免重複建立相同群組。

4. 儲存後更新

   儲存並返回 Home，向下滑動以執行更新。等這次請求完成後，再檢查群組內的項目數量與提示；請勿在請求尚未完成時連續重新整理。

5. 記錄這次結果

   記下這次更新的時間、使用的網路與提示原文。下次只變更一項條件，例如切換網路，才能判斷差異來自哪裡。

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

上方網址僅用於說明 URL 結構，不是可用的訂閱。? 後的參數、參數之間的 &，以及百分比編碼，都可能是原始網址的一部分。不要把聊天工具顯示的省略號當成連結內容，也不要自行解碼後重新組合。若從網頁原始碼複製到字面形式的 &，請回到頁面的複製入口重新取得網址，不要憑猜測修改權杖。

[Check]

ss://、vmess://、vless://、trojan:// 通常代表單一項目的分享內容，並不等同於可定期擷取的 HTTPS 訂閱網址。單一項目應使用相應的匯入方式處理；只把前綴改成 HTTPS，並不會因此取得訂閱更新功能。

回應內容：HTTP 成功不代表解析成功

請求抵達伺服器後，還需要確認伺服器實際回傳了什麼。HTTP 狀態碼描述請求的處理結果，訂閱能否解析還取決於回應本文是否包含可辨識的項目內容。因此，瀏覽器能開啟某個網址，只能表示該網址有回應，不能單憑頁面顯示正常就判定訂閱有效。

有些訂閱會將項目清單編碼後回傳，有些則回傳可直接讀取的文字；不能只憑「看起來像一長串字元」就判定內容損毀。反過來說，排版完整的 HTML 頁面也可能透過 HTTP 200 回傳，卻不包含任何可匯入項目。請向自己的服務商確認，該介面提供的是 Shadowrocket 可辨識的訂閱內容，而非僅供網頁閱讀的說明。

• 回應本文為空：請服務商確認該帳戶目前是否應有項目、介面是否已產生內容，以及快取是否仍回傳舊結果。
• 回應本文是登入或驗證頁面：瀏覽器可能利用已登入狀態顯示內容，但 App 的訂閱請求不具備相同的工作階段條件；請取得適用於用戶端的訂閱網址。
• 回應本文包含錯誤說明：依照說明確認授權、帳戶狀態或請求限制，保留錯誤原文，不要將錯誤文字貼到 Add Server 的其他欄位。
• 只出現部分項目：請服務商檢查未出現項目的分享格式、必要欄位與協定參數；不能只因部分匯入成功，就判定所有內容都正確。

服務商端：依回應原文處理，不猜測故障原因

以下卡片列出標準 HTTP 回應狀態短語，不代表 Shadowrocket 一定會逐字顯示相同提示。只有在 App 提示、請求診斷結果或自己的服務商記錄中看到對應狀態碼時，才依該分支處理；若只有「解析失敗」，不能直接推斷是驗證失效或存取受限。

如果服務商表示介面已恢復，但用戶端仍顯示空白，請進一步確認是「更新時沒有取得新內容」，還是「取得的新內容仍為空」。提供更新時間、狀態碼、項目數量變化與提示原文，有助於對方查明問題；截圖與記錄中的訂閱 token、密碼、UUID 等驗證資訊應先遮蔽，也不要在公開討論區貼出完整 URL。

更新時機：網路路徑、代理更新與自動連線

更新訂閱需要能連線至訂閱網域，連線至項目則需要能連線至該項目的伺服器；兩者的網域與網路路徑可能不同。某個項目可以連線，不代表目前能直接連線至訂閱網域；訂閱網域可以存取，也不代表每個項目的伺服器都正常。

若直接連線請求逾時，而既有項目仍可正常使用，可以先建立可用連線，再前往 Settings → Subscribe 確認 Update via Proxy，視需要啟用後返回 Home 更新。此設定會改變訂閱請求的存取方式，無法修復錯誤權杖、空白回應或伺服器端格式問題。若沒有可用連線，單獨啟用此設定也無法自動建立可用的更新通道。

• 先完成網路登入：若新連線的 Wi-Fi 需要網頁驗證，請先完成驗證，再返回 App 更新；不要把驗證頁面當成訂閱回應。
• 先檢查目前的連線設定：Global Routing 中的 Proxy、Direct、Config、Scene 是流量處理模式，不是訂閱格式選擇器。確認目前設定即可，不必逐一切換來嘗試解析。
• 留意自動連線條件：Settings → On Demand 用於依條件觸發連線，不是訂閱更新開關。記錄此設定是否造成連線狀態變化，避免測試期間網路路徑不斷改變。
• 切換網路後再試一次：改用另一個可使用的網路重試，有助於判斷是否為網路路徑問題；但請記錄變更的條件，不要同時修改 URL 與其他設定。
• 等待伺服器端設定生效：帳戶狀態或訂閱內容剛變更時，請以自己的服務商確認的生效時間為準，不要預設「等幾分鐘就一定會恢復」。

不要因訂閱更新錯誤而關閉憑證驗證。出現 TLS 相關提示時，先確認裝置的日期與時間、訂閱網域是否正確，再請服務商檢查憑證與憑證鏈。若只有特定網路發生問題，保留該網路下的提示作為診斷資料，比略過安全檢查更有助於找出原因。

常見問題：保留資料並完成最後一輪檢查

最後依序確認「完整 URL → Subscribe 類型 → 回應本文 → 伺服器狀態 → 更新網路 → 重試時機」。每次只變更一項條件，完成一次請求後再記錄結果。若需要回報問題，以下清單足以描述狀況，也能避免洩露完整驗證資料。

1. 說明是首次匯入時顯示空白、既有訂閱更新失敗，還是更新後缺少部分項目。
2. 提供問題發生時間、Wi-Fi 或行動網路等連線條件，以及是否使用 Update via Proxy。
3. 保留提示原文與可確認的 HTTP 狀態碼；若沒有狀態碼，請明確註明「未取得」，不要猜測。
4. 說明更新前後的項目數量，以及服務商是否確認目前應有有效項目。
5. 只透過私人支援管道向自己的服務商提供必要資料；公開截圖請先遮蔽 token 與其他驗證欄位。