適用於 v2rayN、v2rayNG 中「訂閱已儲存，但更新失敗或沒有節點」的情況。先判斷問題發生在下載還是解析，再檢查連結權限、回應格式和更新路徑，最後處理用戶端相容性。每次只調整一項設定，保留仍可用的節點，別一開始就清除設定。
先分辨下載失敗與解析結果為空
儲存訂閱網址，只代表用戶端記住了網址，不代表已取得節點。更新時必須依序完成網域解析、連線至訂閱服務、取得回應、辨識格式並寫入群組。最後顯示空清單，可能是其中任一步驟失敗，也可能只是選錯群組。
先開啟用戶端記錄檔，記下更新時間附近的第一則錯誤。別只看最後一則「更新失敗」，它往往是結果而非原因。瀏覽器能開啟服務商首頁，也不代表訂閱介面可用；首頁和訂閱介面可能使用不同網域、存取權限及網路路徑。
| 觀察到的情況 | 優先檢查項目 | 暫時不要做的事 |
|---|---|---|
| 要求逾時、連線遭拒 | 網域解析、網路路徑、目前的代理是否可用 | 反覆切換節點協定參數 |
| HTTP 401 或 403 | 連結權杖、帳戶權限、介面存取限制 | 先入為主地認定是編碼問題 |
| 下載完成，但匯入後沒有節點 | 回應是否為登入頁面、空白內容或不相容格式 | 只憑下載完成就判定訂閱正常 |
| 更新成功，但清單中看不到節點 | 目前的群組、搜尋條件、清單篩選 | 立刻刪除整個用戶端資料目錄 |
檢查連結是否過期及介面權限
訂閱連結通常含有帳戶權杖。重設訂閱、方案到期、權限變更或服務遷移後，舊連結仍可能連得上，卻只會回傳提示頁面。請從服務商的訂閱管理頁面重新複製適用於目前用戶端的連結，別複製瀏覽器網址列中的控制台網址。
-
保留現有群組
先記下目前的群組名稱和更新時間。若還有可用節點，請先備份設定再測試新連結；別用未知內容覆蓋唯一可用的群組。
-
確認連結來源
在服務商頁面確認帳戶狀態及訂閱權限，再使用頁面提供的複製按鈕。檢查連結首尾的空格、換行及複製時帶入的引號，並保留原有查詢參數。
-
檢查群組網址
在 v2rayN 開啟「訂閱分組」→「訂閱分組設定」，編輯目標群組並檢查「地址」。在 v2rayNG 開啟側邊選單的「訂閱分組設定」，編輯相應項目中的訂閱地址。不同版本的介面入口可能有所變動。
-
更新目標群組
儲存後只更新這個群組，並記下是否出現權限錯誤或解析錯誤。若必須重設訂閱權杖，也要同步替換其他裝置上的舊網址，避免把舊連結失效誤判為裝置故障。
以下數字是 HTTP 回應狀態碼，不是用戶端版本號，也不是實測成功率。這些狀態碼有助判斷下一步該檢查權限還是回應內容。
編碼與格式：取得內容不代表可以匯入
「V2Ray 訂閱」並非任何設定檔都能匯入的通用入口。常見內容是逐行排列的分享連結，或將整份連結清單以 Base64 編碼。VMess 分享連結本身也可能包含編碼結構；別因此把整份訂閱重複編碼，也不要手動刪除結尾字元。
VLESS 是節點使用的協定之一；訂閱則是散布多個節點的方式。用戶端能執行某類節點，不代表它能辨識服務回傳的任何設定文字。完整的核心 JSON 設定、結構化設定文件和分享連結清單，必須使用各自適合的匯入入口。
- 回傳 HTML：若出現登入表單、驗證碼或網頁標題，代表取得的是網頁，而非節點清單。請返回服務商頁面，選擇正確的用戶端訂閱入口。
- 回傳 JSON：先確認內容是介面錯誤訊息，還是完整的核心設定；不能只因為有大括號就當成訂閱。若錯誤訊息提及權限或到期，應優先處理。
- 回傳空白內容：確認服務商是否確實提供節點，以及群組篩選條件是否排除了所有內容。空白回應無法靠切換核心變出節點。
- 回傳分享連結：確認內容包含用戶端支援的協定與參數。若只辨識出部分節點，請逐一比較協定和傳輸設定，別一概歸咎於網路。
若要檢視回應，盡量在本機操作，並留意瀏覽器可能使用系統代理，但用戶端更新可能採用直接連線；不能忽略網路路徑差異來比較兩者結果。訂閱服務也可能依據要求標頭回傳不同內容，因此瀏覽器顯示網頁只能作為線索，仍須參考用戶端記錄檔和服務商說明確認。
更新時應使用代理還是直接連線
這是「節點可用，但訂閱更新失敗」時最常見的原因之一。一般網路流量經過目前的代理，不代表訂閱下載也會走相同路徑。反過來說，若訂閱更新依賴已失效的節點，即使訂閱服務正常，要求也可能一直逾時。
-
固定測試條件
使用相同網路和訂閱網址，只變更更新方式。先確認目前的代理節點能否連線至一般 HTTPS 網站；不要同時更換 DNS、節點和路由規則。
-
先試著直接更新
在 v2rayN 的「訂閱分組」選單中選擇「更新全部訂閱(不通過代理)」。括號可能因介面版本而顯示為全形；重點是選擇明確標示不通過代理的指令，並觀察這個群組的結果。
-
再試著透過代理更新
若直接連線逾時，且已有可用節點，再選擇「更新全部訂閱(通過代理)」。如果目前節點已無法使用，別反覆執行相同指令；請先恢復一條可用連線，或改用能直接連至訂閱介面的網路。
-
記錄並比較結果
分別記下直接連線和透過代理時的錯誤類型。在 v2rayNG 中，可從主畫面選單執行「更新訂閱」；其下載路徑會受版本和執行狀態影響，不應直接套用桌面版的選單邏輯，應搭配記錄檔和目前連線狀態交叉確認。
若記錄檔顯示無法連線至本機代理連接埠，請核對用戶端實際監聽的位址和連接埠，別照抄他人的連接埠號碼。若改用代理更新後成功，只能證明這次連線路徑可用；不代表訂閱必須永遠透過代理，也不能證明所有節點都正常。
依照實際錯誤判斷下一步
不同平台和網路程式庫的錯誤文字可能有所差異。以下列出常見錯誤訊息片段；還要確認連線對象是訂閱網域、本機代理還是節點伺服器，不能只憑單一關鍵字下結論。
錯誤：401 Unauthorized
原因與解決方式：要求未通過身分驗證，可能是訂閱權杖失效或缺少驗證資訊。請從服務商頁面重新複製連結，並確認查詢參數完整無缺。
錯誤：403 Forbidden
原因與解決方式：伺服器拒絕存取，可能與帳戶權限、來源限制或存取政策有關。請查看服務商狀態和介面說明，不要只憑這項錯誤就認定方案已到期。
錯誤：429 Too Many Requests
原因與解決方式：要求觸發頻率限制。請停止連續點選更新，依照回應中的重試提示等待，並確認是否有多部裝置同時頻繁重新整理。
錯誤：No such host is known
原因與解決方式：網域解析失敗。先檢查訂閱網域拼字，以及目前網路能否使用 DNS；確認網域沒有遷移後，再調整解析路徑並重試。
錯誤：Connection refused
原因與解決方式：目標位址的對應連接埠拒絕連線。若目標是本機代理，請檢查核心是否正在執行，以及連接埠是否一致；若目標是遠端訂閱服務，請更換連線路徑確認後再向服務商回報。
若出現憑證錯誤，先檢查系統日期、時間和時區，再確認訂閱網域是否與憑證相符。別為了成功更新訂閱而關閉憑證驗證；節點編輯頁中的安全選項也不一定會控制訂閱下載所用的 HTTPS 連線。
確認用戶端版本及更新結果
舊版用戶端可能無法辨識新加入的分享連結參數，或無法處理訂閱服務目前的回應格式。不過，訂閱解析通常由用戶端負責，節點連線則主要由核心執行，兩者並非同一階段。單純更換 Xray 或 V2Fly 核心，通常無法修復下載到登入頁面或權杖過期等問題。
- 記錄目前狀態：在「說明」或「關於」頁面記下用戶端版本；同時記錄錯誤時間、作業系統和更新方式，方便升級前後比較。
- 先備份再升級：前往下載頁選擇適用平台的安裝套件，依照安裝說明更新。桌面版請先退出程式；行動裝置則要保留應用程式資料和現有設定。
- 選擇相符的匯入方式：v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心。請依照服務商提供的相容說明選擇訂閱，不能假設兩者支援的協定參數完全相同。
- 分別確認兩項結果：先確認群組中已顯示節點，再選取一個節點測試連線。成功匯入不代表線路可用，連線逾時也不代表訂閱解析失敗。
若更新顯示成功但清單為空，先清除搜尋文字、切回目標訂閱群組，並檢查是否啟用了篩選。若只有某個群組異常，可用臨時測試群組驗證新網址；完成後再整理舊群組，避免重複節點影響判斷。
回報問題前的自我檢查清單
有效的問題回報應讓對方看出「哪個環節出錯，以及已經做過哪些交叉測試」。不要傳送完整設定，也不要只附上看不出時間和群組資訊的空清單截圖。以下清單可供自行檢查，也適合整理後提供給服務商或用戶端支援人員。
- 帳戶訂閱權限有效，連結來自目前的服務商頁面，且已排除舊權杖和控制台網址。
- 已記下用戶端名稱、實際版本、作業系統平台，以及發生錯誤時使用的更新選單。
- 記錄檔保留了第一則相關錯誤，並已隱藏網域、權杖、節點憑證及個人資訊。
- 已分辨逾時、HTTP 拒絕和內容解析失敗，沒有把這三種情況都混稱為「訂閱不能用」。
- 情況允許時已比較直接連線與透過代理的結果，並說明目前的代理本身是否可用。
- 已確認回應類型和群組篩選；升級前已備份，沒有因反覆重新安裝而遺失唯一可用的設定。
排查順序可固定為：網址與權限、下載路徑、回應格式、用戶端相容性。尚未確認前一步之前，不要同時變更後續多項設定。這樣既能縮小問題範圍，也能在恢復後確認究竟是哪項設定解決了問題。