適合遇到「訂閱更新失敗」、「匯入後沒有節點」或「更新完成但清單空白」的使用者。請依序檢查網址、回應內容、編碼與網路路徑，先判斷是下載失敗還是解析失敗，再分別在 v2rayN 和 v2rayNG 中測試；請先保留仍可使用的設定，不要反覆刪除訂閱來試錯。
先釐清：請求失敗，還是解析結果為空
更新訂閱並不是測試「節點是否連得上」。用戶端會先向訂閱伺服器要求內容，再將回傳文字解析為設定，最後寫入對應的群組。節點能連線，不代表訂閱網址仍有效；訂閱更新成功，也不代表新節點的傳輸與驗證參數一定可用。
先記下更新時間、群組名稱，以及記錄中最早出現的錯誤。記錄的入口會因介面版本而異，可查看主畫面的記錄區域或記錄視窗。後續出現的「沒有可用設定」可能只是前面的請求失敗所致，應優先處理最早出現的錯誤。
- 逾時、網域名稱解析失敗、連線遭拒：請求沒有取得可用回應，應先檢查網路路徑，不必急著修改 Base64。
- 收到回應，但顯示格式錯誤或匯入數量為零：請確認回傳內容是否為訂閱，以及用戶端是否支援該格式。
- 顯示更新成功，介面卻沒有項目：先切回目標群組，清除搜尋與篩選條件，再確認回應內容是否真的包含節點。
檢查網址：複製訂閱連結，不是帳戶頁面
常見錯誤是複製帳戶控制台、購買頁面，或瀏覽器重新導向後的登入網址。這些網址雖然可以正常開啟，通常回傳的卻是網頁，而不是用戶端需要的訂閱文字。請前往服務提供者的訂閱區域，複製適用於目前用戶端的完整網址。
-
保留舊設定
先記錄現有群組與更新結果。需要備份時，使用用戶端的匯出功能，並將備份留在本機；不要先刪除仍可使用的節點。
-
開啟群組設定
在 v2rayN 主畫面依序選擇「訂閱群組」→「訂閱群組設定」，選取發生問題的群組，檢查訂閱網址欄位，而不是編輯個別節點的伺服器網址。
-
重新複製網址
從服務提供者的頁面重新複製完整訂閱連結。檢查開頭的通訊協定、結尾的權杖，以及中間是否被通訊軟體插入換行；移除誤帶的引號與前後空白，但不要改動網址內的字元。
-
更新單一群組
儲存後只更新這個群組，並查看記錄。部分介面需先選取群組，或從右鍵選單更新；先單獨檢查發生問題的群組，避免多個訂閱的錯誤混在一起。
網址中的查詢參數通常用於身分驗證。字元 & 用來分隔參數，%2F 等序列則是 URL 編碼，不要憑感覺刪改。如果從網頁原始碼複製到字面文字 &，可能會破壞參數；請回到頁面使用複製按鈕取得原始網址，不要手動逐段修補。
檢查回應：HTTP 成功不代表格式正確
HTTP 狀態碼有助判斷伺服器是否接受請求，但無法證明回應內容可以匯入。以下三個數字是標準回應狀態碼，不是本站實測資料，也不是節點延遲。
在本機瀏覽器檢查訂閱時，可能會看到純文字、下載提示或登入頁面。瀏覽器有帳戶 Cookie，用戶端則未必有；因此「瀏覽器能開啟」只能作為線索，不能據此判定用戶端請求成功。請勿將瀏覽器的登入狀態視為訂閱驗證的一部分。
| 看到的內容 | 可能原因 | 下一步 |
|---|---|---|
<!DOCTYPE html> 或登入表單 | 取得的是網頁、驗證頁面或錯誤頁面 | 重新取得用戶端訂閱連結，並檢查帳戶狀態與存取限制 |
| 回應本文為空 | 訂閱未指派節點，或伺服器回傳空內容 | 確認帳戶有效期限、方案狀態，以及服務提供者後台的節點清單 |
多行 vmess://、vless:// 文字 | 可能是逐行分享連結格式的訂閱 | 確認用戶端支援對應的通訊協定與連結參數 |
| 一長串編碼文字 | 可能是以 Base64 編碼的訂閱，也可能不是 | 只在本機檢視解碼結果，確認是否能辨識出分享連結 |
| YAML、JSON 或結構化錯誤訊息 | 選錯訂閱格式，或收到 API 錯誤回應 | 在服務提供者頁面選擇適用於目前用戶端的輸出格式 |
不要因為副檔名是 .txt 就認定格式正確，也不要因為網址沒有副檔名就判定它失效。真正決定匯入結果的是回應本文與用戶端的解析能力。伺服器也可能依據請求標頭回傳不同格式；手動偽裝請求標頭並非首選的修復方式。
檢查編碼：先確認格式，再處理 Base64
常見的訂閱格式包括逐行排列的分享連結，以及將整份連結清單以 Base64 編碼的文字。Base64 是編碼，不是加密。有些 vmess:// 分享連結內部也會使用 Base64，但這與整份訂閱的外層編碼並非同一層。
- 外層訂閱：解碼後通常會看到一條或多條分享連結，請逐行確認是否包含完整的通訊協定前綴。
- VMess 連結內部：常見格式是經編碼的 JSON；如果內部內容遭到截斷，即使外層訂閱解碼成功，也可能無法匯入。
- VLESS 連結：通常採用 URI 結構，透過查詢參數描述傳輸與安全設定，不應將整條連結強行當成 Base64 解碼。
- 填充字元：結尾缺少
=不一定代表內容損毀；有些實作允許省略填充。不要只憑這一點修改原始內容。
複製時遭到截斷、+ 被誤轉成空格，或插入全形標點，都可能破壞編碼。解析器是否容許換行則因實作而異；重新取得原始內容通常比手動拼接可靠。如果在本機看到的解碼結果仍是另一層編碼，也不要反覆套用編碼來「修復」訂閱，請改由服務提供者輸出用戶端支援的標準格式。
檢查網路：分別測試直連與透過代理更新
更新訂閱的請求路徑，不一定與一般網頁的存取路徑相同。v2rayN 的訂閱選單可能提供不透過代理及透過代理的更新選項，實際名稱會因版本而異。切換系統代理，不一定會改變用戶端本身的訂閱請求方式；啟用 TUN 時，也可能仍會影響原本預計直連的請求。
- 先測試不透過代理：在 v2rayN「訂閱群組」選單中，選擇「更新所有訂閱（不透過代理）」，或對應的單一群組直連更新選項，並記錄結果。如果正在使用 TUN，先確認這次請求是否受到 TUN 接管。
- 再測試透過代理：只有在已有節點可正常連線上網時，才使用「更新所有訂閱（透過代理）」或對應的單一群組選項。如果舊節點全數失效，這個方式可能沒有可用的連線出口。
- 檢查本機監聽：前往「設定」→「參數設定」，查看實際的本機監聽連接埠。如果記錄顯示連線至本機迴路位址遭拒，請確認核心運作正常、連接埠沒有變更，且未被其他程式占用。
- 更換網路重新測試：在允許的情況下改用另一個網路，一次只變更這個條件。如果同一個網址在另一個網路上能成功，請優先檢查原網路的 DNS、存取政策或連線品質。
憑證錯誤需要另外處理。請先啟用系統時間自動同步，再確認訂閱網域拼寫、憑證有效期限，以及目前網路是否出現登入驗證頁面。不要長期關閉 TLS 驗證；這無法修復失效網址，還會降低訂閱內容傳輸時的保護。
錯誤：401 Unauthorized
原因：請求缺少驗證資訊、驗證資訊已過期，或伺服器不接受該資訊。解決方法：從服務提供者後台重新取得訂閱網址，確認權杖完整，不要只重試舊連結。
錯誤：403 Forbidden
原因：伺服器拒絕此次存取，可能與帳戶狀態、來源限制或驗證頁面有關。解決方法：檢查後台狀態，比較直連與代理的結果，並聯絡服務提供者確認存取限制。
錯誤：404 Not Found
原因：請求路徑不存在，或伺服器以此狀態隱藏失效的連結。解決方法：重新複製目前的訂閱連結，並確認是否使用了舊網域、舊路徑或遭截斷的網址。
以上是常見 HTTP 錯誤的原始訊息；用戶端記錄可能會另外附上狀態碼或本地化說明。不要把伺服器回傳的錯誤頁再交給 Base64 解碼器；先排除請求層的錯誤，才會有可供解析的訂閱本文。
用戶端重新測試：每次只變更一個條件
v2rayN 是桌面用戶端，v2rayNG 則是使用 Xray 核心的 Android 用戶端。訂閱的取得與解析主要由用戶端處理，因此更換核心並不是解決訂閱錯誤的通用方法。只有記錄明確指出涉及特定設定或核心功能時，才進一步檢查相容性。
- v2rayN：前往「訂閱群組」→「訂閱群組設定」，確認目標群組與 URL，儲存後執行更新；接著切回該群組並清除搜尋條件。比較更新前後的項目，不要只看跳出的完成提示。
- v2rayNG：在主畫面點選右上角選單，進入「訂閱群組設定」並核對群組網址；返回主畫面後，從選單執行「更新訂閱」。選單名稱可能因版本而異，請以目前介面顯示為準。
- 跨裝置比較：使用同一個仍有效的訂閱連結，記錄用戶端版本、更新時間與使用的網路。不同用戶端可能支援不同的輸出格式，不能只因另一台裝置更新成功，就判定本機網路正常。
- 還原順序：先確認訂閱能正常更新，再測試個別節點是否可用，最後還原所需的系統代理、TUN 與路由分流設定。不要同時修改網址、DNS、核心與路由。
常見問題：更新完成卻仍看不到節點
顯示更新成功，為什麼清單還是空的？
先選取剛更新的訂閱群組，清除關鍵字與篩選條件，再檢查記錄中的匯入數量。請求成功但回應內容為空、格式不符或所有項目都遭到篩選，都可能導致看不到節點；應比對回應本文來判斷。
瀏覽器能開啟，為什麼用戶端會報錯？
瀏覽器可能帶有登入 Cookie，也可能使用了不同的代理。請先確認開啟的是訂閱本文而非帳戶網頁，再分別測試用戶端的直連與代理更新方式；不要把瀏覽器的登入連結填入訂閱欄位。
舊節點全部失效，還能透過代理更新嗎？
如果沒有可用的代理出口，透過代理更新通常無法解決問題。請先嘗試直連，或改用另一個可以連上訂閱網址的網路更新；如果仍然失敗，請服務提供者確認連結是否可連線及帳戶狀態。
提供哪些資訊給服務提供者才有幫助？
提供用戶端名稱與版本、發生時間、HTTP 狀態碼、直連與代理各自的結果，以及已遮蔽敏感欄位的錯誤記錄。完整訂閱網址只透過對方認可的私密管道提供，請勿張貼在公開討論區。
最後可歸納成三項：網址是否仍有效、回應是否為用戶端支援的訂閱格式，以及請求路徑是否可連線。分開驗證這三項，比不斷點選更新或重新安裝用戶端更容易找出問題。確認用戶端版本過舊後，再從下載頁選擇合適的安裝套件，並保留原有設定的備份。