先保留現有節點，再檢查訂閱網址與伺服器回應，接著分辨是網路請求失敗還是內容解析失敗。本文適用於 v2rayN 桌面版與 v2rayNG Android 版；依序檢查連結、更新路徑、格式及系統時間，就能判斷問題出在哪個環節，避免反覆刪除訂閱或更換核心。
先釐清：沒有下載到內容，還是內容無法解析
「更新失敗」只描述結果，並非原因。訂閱更新通常由用戶端發出 HTTP 請求、取得文字、解析節點，再寫入對應群組。這不等於測試節點連線，也不代表 Xray 或 V2Fly 已成功啟動。更新失敗時，先查看用戶端記錄中最早出現的錯誤，不要只看最後一行「匯入失敗」。
- 未取得回應本文：優先檢查網域解析、連線逾時、代理路徑、TLS 憑證及 HTTP 狀態碼。
- 已取得回應本文，但匯入數量為零：優先確認回傳內容是否為登入頁、錯誤訊息、空白文字，或用戶端不支援的訂閱格式。
- 更新成功但節點無法使用：改查伺服器位址、連接埠、協定參數及路由規則，不要再將問題歸類為訂閱下載失敗。
第一步：重新複製訂閱網址，確認授權狀態
先排除連結本身的問題。訂閱網址通常帶有存取權杖，不能用帳戶首頁、購買頁面或單一節點分享連結取代。複製時漏掉查詢參數、混入換行，或將半形 & 變成文字 &，都可能造成請求未獲授權或指向錯誤資源。
-
保留舊群組
記下原有群組和節點數量。先編輯訂閱網址，不要刪除所有伺服器，以免遺失仍可連線的節點。
-
複製專用連結
前往訂閱服務提供者的帳戶頁面，找到訂閱匯出入口，選擇適用於 v2rayN 或 v2rayNG 的格式。使用複製按鈕，避免從聊天截圖或換行文字拼湊網址。
-
檢查連結是否完整
確認通訊協定、網域、路徑及查詢參數完整，並移除前後空白與包住網址的引號。若權杖已重設，舊網址通常無法繼續使用，請重新複製。
-
只更新該群組
儲存網址後，只更新目標群組並記錄完整結果。不要同時更新多個來源，以免記錄中的逾時和授權錯誤混在一起。
可在可信任的本機瀏覽器開啟訂閱網址，協助判斷是否有回傳文字或下載檔案。不過，瀏覽器可能帶有登入 Cookie、使用不同代理，或收到不同的伺服器回應，因此「瀏覽器能開啟」不能單獨證明用戶端也能成功。請勿將完整網址貼到線上解碼、測速或轉換網站。
第二步：查看 HTTP 狀態，別把登入頁當成訂閱內容
HTTP 狀態碼有助於縮小問題範圍，但無法單獨證明內容正確。以下數字是標準回應狀態碼，不是測速結果。若用戶端沒有顯示狀態碼，可查看記錄；服務提供者後台的請求紀錄也可作為參考。
| 回應狀況 | 優先判斷 | 下一步 |
|---|---|---|
200，本文以 <!DOCTYPE html> 開頭 | 回傳的是網頁，可能為登入、驗證或錯誤頁面 | 重新取得訂閱專用網址，並向服務提供者確認供程式請求使用的入口 |
401 或 403 | 憑證無效、權限受限，或存取遭政策封鎖 | 檢查權杖與帳戶狀態；403 不一定代表方案已到期 |
404 或 410 | 路徑不存在，或資源已移除 | 從帳戶頁面重新複製目前的訂閱網址 |
429 | 更新過於頻繁，或觸發伺服器的流量限制 | 停止連續點擊；若回應包含 Retry-After，請依指示等待 |
5xx | 伺服器或上游處理失敗 | 保留舊節點，稍後再試並聯絡服務提供者 |
第三步：分別測試直連更新與代理更新
訂閱網域與節點伺服器並非同一個目標。節點可用，不代表能直接連上訂閱網域；訂閱可下載，也不代表節點能連線。v2rayN 的更新選項可能分為「不透過代理」和「透過代理」，應分別測試；不要只切換系統代理，就認定更新請求已改變連線路徑。
-
找到訂閱設定
在 v2rayN 開啟「訂閱分組」→「訂閱分組設定」，確認目標群組網址。不同版本的介面用詞可能略有差異，請以目前視窗中名稱相近的選項為準。
-
測試直連更新
在「訂閱分組」中選擇「更新目前訂閱（不透過代理）」。只測試一次，並記錄是否逾時、憑證錯誤或收到 HTTP 錯誤。
-
確認代理可用
選擇先前確認可用的節點並啟動核心，再選擇「更新目前訂閱（透過代理）」。如果所有舊節點都已失效，這種方式無法憑空恢復連線。
-
確認 Android 群組設定
在 v2rayNG 主畫面點選右上角選單，進入「訂閱分組設定」，檢查網址並儲存；返回主畫面，選擇目標群組，再從選單執行「更新目前群組訂閱」。
-
重新測試並比對結果
v2rayNG 可分別在服務停止及啟動既有可用服務後重試，比較記錄結果。不能只看 VPN 狀態判斷訂閱請求的連線路徑，也要確認目前版本的更新選項與路由設定。
第四步：確認編碼與訂閱格式相符
常見的訂閱本文是多筆分享連結，或是將這些連結組成的文字以 Base64 編碼後的內容。用戶端必須先辨識外層內容，再解析各個節點。單筆 vmess:// 的資料也可能有自己的編碼層；不要反覆解碼整份回應，直到「看起來像文字」為止。
- 分享連結清單：檢查解碼後的文字是否包含
vmess://、vless://或trojan://等用戶端支援的協定連結，並確認項目完整。 - 錯誤文件：若 JSON 物件只有
error、message等錯誤欄位，通常是 API 回應，不應匯入為節點清單。 - 格式不符：YAML 設定檔或完整的核心 JSON 設定，不一定能當成訂閱連結清單解析。請在服務提供者的匯出入口選擇目標用戶端格式。
- 傳輸內容損毀：遭截斷的 Base64、被替換的字元或錯誤的編碼層級，都可能造成解析失敗。請優先重新取得原始回應，不要手動補字元。
若回應中混有空白行、提示文字或部分不支援的節點，用戶端可能只匯入部分內容，也可能回報錯誤；結果取決於解析器的實作方式。更新後的節點數量少於原本時，請檢查匯入記錄及服務提供者目前回傳的內容，不要直接認定用戶端刪除了節點。
訂閱解析是用戶端的功能；節點能否運作才與核心能力有關。若用戶端無法辨識 VLESS 參數或其他協定欄位，先確認用戶端版本與匯出格式；單純將 Xray 換成 V2Fly，無法修復回傳網頁或損毀的 Base64。
第五步：依實際錯誤排查 DNS、TLS 與時間問題
以下列出網路或解碼函式庫常見錯誤的原文片段。實際大小寫、前綴及附加資訊會因用戶端版本而異，也不一定會出現在每種用戶端中。判讀時請留意錯誤發生的階段，避免將核心連線記錄誤認為訂閱下載記錄。
錯誤：No such host is known
原因：網域解析未取得可用結果，可能與網址拼寫、系統 DNS 或網路環境有關。
處理方式：先確認訂閱網域，再於相同網路重試；必要時改用另一個可信任的網路比對。確認問題後，再調整實際請求路徑所使用的 DNS。
錯誤：Connection refused
原因：目標位址的連接埠拒絕連線；若目標是本機位址，通常應先檢查本機代理是否正在監聽。
處理方式：查看錯誤中的主機和連接埠，確認目標是訂閱伺服器還是本機代理，再分別檢查遠端服務或本機核心的運作狀態。
錯誤：x509: certificate has expired or is not yet valid
原因：憑證有效期間與裝置目前時間不符，可能是系統時間錯誤，也可能是伺服器憑證確實已過期。
處理方式：校正系統日期和時間後再試；若時間正確仍失敗，應由訂閱服務提供者處理憑證問題，請勿關閉憑證驗證。
錯誤：illegal base64 data at input byte 0
原因：交給 Base64 解碼器的內容從開頭就不符合預期，常見原因是格式錯誤或收到網頁回應。
處理方式：檢查回應本文開頭與匯出格式，重新取得完整訂閱；實際錯誤訊息中的位元組位置也可能是其他數字。
Windows 可前往「設定」→「時間與語言」→「日期與時間」，開啟自動設定時間並執行同步。Android 可前往系統「設定」中的「日期與時間」，啟用網路提供的時間；各品牌介面位置可能不同。時區主要影響時間顯示，也請確認實際日期和時間正確。
更新成功後：確認群組，再測試節點
成功提示只代表這次更新流程已完成。還要確認目標群組是否出現預期節點、是否看錯群組，以及有沒有重複項目。選取一個節點進行連線測試，分別確認「訂閱匯入完成」和「網路服務恢復」。
- 群組是空的：檢查是否選錯群組、伺服器是否回傳空白訂閱，以及記錄中是否顯示所有項目解析失敗。
- 有節點但測試失敗：檢查伺服器位址、連接埠、TLS 主機名稱及協定參數；訂閱已成功時，不要反覆重新產生權杖。
- 只有部分應用程式異常：檢查系統代理、TUN 或應用程式本身的代理設定，以及路由分流規則。這不屬於訂閱解析階段。
- 需要協助：提供用戶端名稱、實際版本、作業系統、失敗時間、更新方式及已遮蔽敏感資訊的錯誤行；隱藏完整訂閱網址、權杖、節點憑證及帳戶資訊。
也要設定明確的排查停止條件：取得正確回應並成功匯入後，就停止修改訂閱相關設定。若確認是授權失效或伺服器錯誤，請保留可用設定並向服務提供者確認，不要繼續修改 DNS、連接埠和核心，以免擴大問題範圍。