V2Ray 訂閱解析失敗、匯入後清單空白：常見原因與排查方法

一、保留現有節點，先確認故障階段

不要一開始就刪除所有伺服器，也不要反覆重新安裝。訂閱更新通常分成三個步驟：連線至訂閱網址、讀取回應內容，再將內容轉換為節點清單。任何一步失敗，都可能顯示清單空白，但處理方式各不相同。

先記下用戶端版本、錯誤時間、分組名稱和完整日誌。版本號可在「說明」→「關於」或設定中的版本資訊查看；不同版本的選單可能略有差異。回報問題時附上完整版本號，比只寫「最新版」更有幫助。若仍有可用節點，請使用用戶端提供的備份或匯出功能儲存至本機；檔案可能包含登入憑證，請勿公開上傳。

二、確認訂閱網址與分組設定

訂閱 URL 是取得一批節點的入口，不是服務商首頁，也不是單一節點的伺服器位址。以 vmess:// 或 vless:// 開頭的內容通常是單一節點分享連結，應使用從剪貼簿匯入節點的功能；HTTP 或 HTTPS 網址也可能只是帳戶網頁，不能只看開頭就認定是訂閱網址。

1. 重新複製網址

   前往服務提供者的帳戶頁面找到訂閱入口，選擇適用於目標用戶端的格式後重新複製。請勿複製瀏覽器網址列中的帳戶頁面，也不要從聊天訊息預覽中複製遭截斷的連結。

2. 檢查完整內容

   使用本機文字編輯器檢查前後空格、換行和多餘的引號。保留查詢參數中的 &、=、% 等字元，不要手動「整理」令牌，也不要重複進行 URL 解碼。

3. 確認訂閱分組

   以 v2rayN 常見的桌面介面為例，開啟「訂閱分組」→「訂閱分組設定」，新增或編輯目標分組，填入備註和訂閱網址後儲存。若目前版本的版面不同，請尋找名稱相同的分組管理功能，不要將訂閱 URL 填入伺服器位址欄位。

4. 只更新目前分組

   返回主畫面，選取剛儲存的分組，再從「訂閱分組」執行更新目前訂閱。初次排查時只更新這個分組，避免其他分組的錯誤日誌混在一起。記下這次新增的節點數量和完整錯誤訊息。

若服務提供者已重設訂閱令牌，舊網址可能仍會開啟提示頁面，卻無法再取得節點。此時應替換分組中儲存的網址，而非只在瀏覽器測試新網址。帳戶到期、流量用盡或裝置數量限制是否會影響訂閱取得，取決於提供者的規定，請至帳戶頁面確認。

三、檢查更新請求：直連或透過代理

瀏覽器能開啟網頁，不代表用戶端更新訂閱時使用相同的網路路徑。瀏覽器可能會使用系統代理，但訂閱更新功能可能明確採用直連。反過來說，即使更新時選擇透過代理，若本機核心未啟動或目前節點無法使用，請求仍會失敗。

• 有可用的舊節點：先選取舊節點並確認連線正常，再到 v2rayN 的「訂閱分組」選單，選擇名稱含有「透過代理」的更新目前訂閱項目。
• 沒有可用節點：先嘗試名稱含有「不透過代理」的更新項目；若目前網路無法連線至訂閱網域，請向提供者索取備用訂閱入口，或改用可存取該網址的網路。
• 透過代理更新後立即失敗：確認核心是否正在執行、本機監聽是否已建立，以及更新功能使用的連接埠是否與目前設定一致。
• 只有某個網路無法使用：改用另一個可信任的網路測試一次，以判斷問題來自本機 DNS、網路存取政策或伺服器故障。請勿同時修改多項設定。

本機代理連接埠沒有統一的固定值。10808 只是常見設定之一，請以目前用戶端顯示的監聽連接埠為準。手動測試代理時，HTTP 代理和 SOCKS 代理也不能任意互換。若使用系統代理進行測試，結束後請還原原本設定，避免其他應用程式繼續使用排錯設定。

四、看懂狀態碼與常見錯誤訊息

以下三種狀態碼描述的是 HTTP 請求結果，不是節點測速結果。這些數字代表的是協定定義，並非本站實測。尤其要注意：收到 200 只表示伺服器正常傳回某些內容，不代表內容就是有效的訂閱資料。

日誌文字會因用戶端版本和作業系統而異。以下列出網路請求中常見的錯誤原文或片段；若日誌同時提供內層例外訊息，請連同內層原因一起查看，不要只截取最後一行。

若回應開頭出現 <!DOCTYPE html>、登入表單或人機驗證頁面，代表用戶端取得的是網頁，而不是節點清單。瀏覽器可能因登入狀態而通過驗證，但獨立用戶端沒有相同的 Cookie。請使用提供者專供用戶端取得訂閱的入口，不要複製登入後的網頁網址。

五、排查格式、編碼與節點相容性

「V2Ray 訂閱」並不是保證通用的檔案格式。常見內容包括逐行排列的分享連結、經 Base64 編碼的連結集合，以及專為特定用戶端提供的完整設定檔。完整 JSON 設定、YAML 設定和連結集合用途不同，不能只靠更改副檔名或重新編碼互相轉換。

VMess 分享連結中的編碼資料，與 VLESS 分享連結的 URI 結構不同。訂閱外層編碼、單一連結內部編碼和 URL 百分比編碼也各不相同。反覆解碼、手動補上字元，或將全形標點改進令牌，都可能破壞原本有效的資料。建議重新下載原始內容，不要手動修補長篇文字。

• 文字亂碼但仍可匯入：先確認是否只有節點備註顯示亂碼。備註顯示異常不代表伺服器位址、連接埠和驗證欄位已損壞。
• 只匯入部分節點：檢查未匯入節點的協定、傳輸方式及相關參數，確認用戶端和目前選用的核心都支援這些設定。
• 同一份訂閱在其他用戶端無法使用：v2rayNG 使用 Xray 核心，v2flyNG 使用 v2fly 核心；兩者支援的參數範圍不一定完全相同。v2rayN 也須配合目前選用的核心判斷。
• 更新用戶端後再次測試：先備份現有設定，再從下載中心選擇適用於作業系統的版本。更新用戶端或許能改善格式支援，但無法修復伺服器傳回的錯誤網頁。

六、更新成功但清單空白：先檢查顯示，再檢查解析

「成功」有時只表示請求已結束，不代表新增了節點。先確認介面目前選取的分組、清空搜尋欄，再檢查是否啟用了篩選條件。若有多個同名分組，可暫時為目標分組加上明確備註，避免混淆 A 組的更新日誌和 B 組的清單。

1. 記錄更新前後的數量：分別記下目標分組的節點數，以及日誌顯示的匯入數量。若介面顯示為零，但日誌指出已匯入節點，請優先檢查分組與篩選條件。
2. 確認回應內容是否為空：在本機查看這次的回應內容，請勿公開資料。回應為空時，應檢查伺服器與帳戶狀態；有內容但匯入數量為零，才繼續排查格式。
3. 用單一連結確認問題：若能安全取得一條完整的分享連結，請使用用戶端的「從剪貼簿匯入」功能測試。若單一連結可以匯入、整份訂閱卻失敗，應優先檢查訂閱外層格式和混入的非節點文字。
4. 確認實際連線：成功匯入後，選取一個節點進行實際連線延遲測試，再確認應用程式是否透過代理存取網路。清單恢復只代表解析環節正常，不代表每個遠端節點都能使用。

每次失敗後不要立即再次更新。連續發出請求可能觸發頻率限制，讓原本的格式問題變成新的存取問題。若日誌出現 429，請停止重試，並依伺服器提示的等待時間再試；若沒有明確提示，先向提供者確認限制規則。

七、訂閱排查常見問題與恢復確認