V2Ray 訂閱更新失敗、節點解析為空的原因與排查步驟

一、分辨請求失敗與解析結果為空

「訂閱更新失敗」可能由不同原因造成。用戶端會先向訂閱網址發出 HTTP 請求，收到內容後辨識格式，再將解析出的節點加入分組，最後顯示在介面上。請求逾時表示可能尚未取得內容；顯示解析失敗，代表收到的內容未必是有效訂閱；清單為空，則也可能是分組選擇或搜尋條件所致。

排查時，先開啟用戶端記錄檔或更新結果提示，記下第一則錯誤訊息及發生時間。不要把連線節點時的核心記錄檔，直接當成訂閱下載記錄：訂閱可能由用戶端自身的網路元件取得，而節點連線則由選用的核心處理。兩者是不同的連線路徑，錯誤訊息不能互相替代。

• 等待一段時間後逾時：先檢查訂閱網域名稱解析、網路連線狀態，以及更新請求是否經過代理。
• 立即顯示解析錯誤：先確認回應是否為登入頁面、錯誤頁面或不支援的設定格式。
• 顯示更新完成，但清單為空：先切換至目標分組、清除搜尋條件，再檢查篩選規則。
• 節點已顯示但無法連線：訂閱匯入流程基本上已完成，接下來應檢查伺服器位址、連接埠、協定參數及 TLS 設定。

二、確認訂閱網址與帳戶狀態

訂閱網址不是服務商首頁，也不是登入後的管理頁面。請從服務商提供的「複製訂閱連結」功能，或用戶端對應的入口重新複製，再貼到訂閱分組的 URL 欄位。連結通常包含存取憑證；請勿將完整網址貼到公開討論區，也不要交給線上解碼或訂閱轉換網站處理。

1. 保留原有設定

   先備份用戶端設定，或保留原有訂閱分組。在確認新連結有效前，請勿刪除唯一可用的節點，也不要連續清空清單並重新匯入。

2. 重新取得連結

   在服務商帳戶頁面確認訂閱效期與授權狀態，重新複製相容於用戶端的訂閱網址。若曾重設訂閱，舊網址可能已失效。

3. 檢查字元

   在本機檢查網址開頭、結尾與查詢參數，移除複製時帶入的空格、換行和引號。請勿自行刪除問號後的參數，也不要將半形符號改成全形符號。

4. 單獨更新此分組

   在 v2rayN 中，可從「訂閱分組」進入「訂閱分組設定」確認 URL；在 v2rayNG 中，可從側邊選單進入「訂閱分組設定」。儲存後，只更新待排查的分組，避免其他訂閱的錯誤干擾判斷。

不同版本的選單文字可能略有差異，請以目前介面中的訂閱分組編輯項目為準。v2flyNG 的入口與選項也應個別確認，不要因介面相似，就認定更新方式完全相同。如果連結來自聊天訊息，請特別檢查結尾是否多了中文句號；如果來自網頁原始碼，也要留意參數分隔符是否被誤複製為 &。

三、檢查更新是否依賴已失效的代理

「更新流量經過代理」本身並不是錯誤，問題在於目前使用的代理是否可用。如果用戶端必須透過已失效的節點下載新訂閱，就會形成依賴迴圈：舊節點無法連線，訂閱請求也會跟著逾時。反過來說，某些網路環境無法直接連線至訂閱網域，此時強制直連也無法解決問題。

在提供相關選單的 v2rayN 版本中，可從「訂閱分組」選擇標示「不透過代理」的更新項目，並與「透過代理」更新項目比較。如果 v2rayNG 的「設定」中有「透過代理更新訂閱」選項，可先記下原本狀態，再切換一次並更新目前分組；若該版本沒有此選項，請勿照搬其他用戶端的操作路徑。

• 若不透過代理時可以更新，透過代理卻失敗，請優先檢查目前選取的節點與本機代理監聽狀態。
• 若透過可用代理時可以更新，直連卻失敗，請保留可用的更新方式，再檢查本機網路的網域名稱解析或存取限制。
• 若兩種方式都失敗，請查看 HTTP 狀態碼與回應內容，不要反覆切換路由模式碰運氣。
• 若同時啟用了 TUN，請留意「不透過代理」通常指的是應用程式層級的請求方式，不保證封包一定會繞過虛擬網卡。必要時記下目前狀態，暫時停用 TUN 後再比較測試結果。

四、根據狀態碼與回應內容判斷問題

能開啟訂閱網域首頁，不代表訂閱介面有效；HTTP 回應 200 也只表示請求成功，不保證內容能正確解析。如果記錄檔顯示狀態碼，請先參考下表縮小問題範圍。若用戶端未顯示回應本文，可向服務商詢問介面錯誤說明；確實需要在本機檢視回應時，請只在可信任的裝置上處理，避免同步或轉傳含有憑證的內容。

瀏覽器可以存取、用戶端卻失敗，也可能是因為瀏覽器已保存登入 Cookie、自動完成網頁驗證，或兩者使用不同的網路路徑。此時複製瀏覽器網址列中的頁面連結通常無效。若記錄檔出現憑證錯誤，請檢查系統時間、請求網域及伺服器憑證；不要以關閉憑證驗證的方式掩蓋訂閱介面問題。

五、檢查 Base64、分享連結與設定格式

訂閱是一種內容分發方式，並非統一的檔案語法。常見回應內容包括逐行排列的節點分享連結，以及將整份連結清單以 Base64 編碼的文字。用戶端支援的格式會隨版本而異，服務商提供的「通用訂閱」也不一定適用於所有用戶端。

• 整份訂閱編碼：部分訂閱會將多行分享連結整體以 Base64 編碼，解碼後才會看到 vmess://、vless:// 等前綴。原文看不到前綴，不代表內容已損毀。
• 單一分享連結：傳統 VMess 分享格式通常會在前綴後附上以 Base64 編碼的 JSON；VLESS 分享連結則通常使用 URI 參數。請勿對所有協定一律執行「解碼兩次」。
• 編碼變體：標準 Base64 與 URL 安全變體使用不同字元集，結尾的填充字元也可能不同。是否接受這些格式取決於解析器，不應隨意替換字元來嘗試修復。
• 完整設定檔：核心的 JSON 設定檔不等同於訂閱連結清單。某個入口能匯入完整設定檔，不代表「更新訂閱」也能讀取相同內容。
• 其他格式：如果回應以 YAML 欄位、網頁標籤或錯誤訊息開頭，而目前入口預期的是分享連結，就應改用服務商提供的相容訂閱入口。

如需驗證編碼，請使用本機工具，只檢查結構，不要將解碼結果上傳至第三方服務。若解碼後仍是 HTML 登入頁，問題依然出在回應內容；若連結缺少伺服器位址、連接埠或必要參數，應請訂閱提供者修正，不能以手動補上欄位取代正確設定。

六、更新成功但清單為空：檢查篩選與顯示

篩選通常發生在取得內容之後。訂閱已回傳節點，用戶端也能辨識，但分組的包含規則、排除規則或介面搜尋可能隱藏了所有結果。請先清空主畫面的搜尋欄，再選取剛更新的分組；不要在另一個空分組中判斷更新結果。

1. 確認分組

   確認訂閱分組名稱與已儲存的 URL，並確認更新提示對應的是目前檢視的分組，而非其他同名分組或舊分組。

2. 暫時清除篩選

   在用戶端提供的分組編輯欄位中記下原有篩選內容，再暫時清空。並非所有版本都提供相同的篩選欄位；若沒有此欄位，請直接檢查搜尋條件。

3. 重新更新單一分組

   只更新目前分組並查看記錄檔。若節點重新出現，表示應檢查篩選規則的作用方式，而不是繼續重設訂閱網址。

4. 逐項還原

   每次還原一項條件，再次檢查清單。先確認欄位代表「保留符合項目」還是「排除符合項目」，再確認它使用一般文字或正規表示式。

只有在欄位明確支援正規表示式時，^$ 通常才表示符合空字串，.* 通常才表示符合任意長度的字串。前者若設為包含條件，可能會篩掉所有非空名稱；後者若設為排除條件，則可能排除所有項目。不要將正規表示式貼到僅支援一般關鍵字的欄位，也不要假設所有版本使用相同的多關鍵字分隔符號。

七、整理重現步驟，避免反覆修改

如果依照上述步驟仍無法找出問題，精簡的紀錄會比完整設定截圖更有幫助。用戶端更新可能影響格式解析的相容性，因此請記下完整版本號，不要只寫「最新版」。如要升級，請先保留原有設定，再從安裝檔頁面選取對應平台的用戶端；不要一開始就解除安裝並重新安裝。

• 環境：用戶端名稱、完整版本號、作業系統，以及是否啟用 TUN。
• 觸發方式：更新單一分組或所有訂閱、使用直連或代理，以及問題是否每次都能重現。
• 請求結果：錯誤原文、HTTP 狀態碼，以及回應是空白內容、網頁還是訂閱文字。
• 顯示結果：清除搜尋與篩選後是否仍為空白，以及其他既有分組是否正常。
• 已嘗試的操作：是否重新取得連結、重設授權、切換網路或修改更新方式；分享紀錄前，請先移除網址中的憑證與節點存取參數。

最後依照「網址有效、請求可達、回應正確、格式相容、篩選合理」的順序逐步確認。每確認一個環節，就先不要再改動該環節，避免同時切換 DNS、路由、核心與訂閱入口，導致問題即使解決，也無法判斷是哪個步驟生效。