訂閱更新失敗時，先確認問題屬於請求未送出、伺服器拒絕請求，還是回應內容無法匯入。本文適用於在 macOS 上使用 v2rayN 的情況，依序檢查連結、更新路徑、憑證與內容格式，最後提供以分鐘計算的自動更新建議。請先保留現有節點，另行測試一個訂閱群組，不必一開始就重新安裝用戶端。
一、先區分訂閱更新與節點連線
訂閱更新是用戶端向訂閱網址發出請求，下載節點資訊並匯入本機群組；節點連線則是由核心依照目前設定連線至遠端伺服器。兩者彼此相關，但並非同一件事：現有節點可以正常連線，訂閱網址仍可能回傳錯誤；訂閱下載成功，也不代表每個節點都能使用。
先開啟 v2rayN 的記錄區，只更新發生問題的群組。記下操作時間、錯誤原文、是否透過代理更新，以及更新前後的節點數量。不要同時切換 DNS、節點與更新方式；否則即使問題排除，也很難判斷是哪項設定生效。
- 保留現況：記下目前可用的節點，並使用用戶端提供的匯出或備份功能儲存設定。備份可能包含憑證，請存放在本機安全的位置。
- 確認群組：前往「訂閱群組」→「訂閱群組設定」，核對群組備註與網址。不同版本的入口可能位於工具列或主選單，請依實際介面尋找同名功能。
- 單一群組重試：在訂閱群組選單中，選擇更新目前群組，避免一次更新所有訂閱，造成記錄內容混雜。
- 判斷問題階段：逾時或連線遭拒時，先檢查網路路徑；出現 HTTP 狀態碼時，先確認伺服器；下載完成卻沒有節點，則檢查內容格式。
二、訂閱連結失效：先檢查網址與回應狀態
請從訂閱服務的帳戶頁面重新複製適用於 v2rayN 的訂閱網址，再與用戶端儲存的網址比對。常見問題包括複製到帳戶管理頁網址、漏掉查詢參數、網址末尾多了空格，或仍在使用已重設的舊權杖。QR Code 只是另一種承載連結的方式，無法保證其中的網址仍然有效。
| 觀察結果 | 優先判斷 | 下一步處理 |
|---|---|---|
| HTTP 401 | 缺少驗證資訊或憑證已失效 | 重新登入服務管理頁面，複製目前有效的訂閱網址 |
| HTTP 403 | 存取遭拒 | 確認帳戶狀態、來源限制與用戶端相容需求 |
| HTTP 404 / 410 | 找不到路徑或資源已移除 | 檢查完整路徑，確認服務方是否更換訂閱入口 |
| HTTP 429 | 請求頻率受到限制 | 停止反覆點擊，優先依照回應中的 Retry-After 提示操作 |
| HTTP 502 / 503 | 伺服器或上游服務暫時異常 | 保留現有設定，待服務恢復後再試 |
| HTTP 200，但無法匯入 | 請求成功不代表回應內容是有效的訂閱 | 確認回應是否為登入頁、驗證頁或錯誤說明 |
狀態碼只能縮小排查範圍，無法單獨證明問題原因。例如 403 可能由訂閱服務或中間的防護層回傳，不要看到 403 就直接認定帳戶已到期。也請查看服務管理頁面的有效期限、流量狀態與回應說明。重設訂閱權杖後，其他裝置儲存的舊網址也需要一併更新。
判斷重點：瀏覽器開得了，不代表用戶端就能匯入
瀏覽器可能帶有登入狀態，也可能只顯示驗證頁面。請先確認回應內容是用戶端可識別的節點資料；若顯示帳戶頁面，應重新複製訂閱入口，而不是繼續調整節點參數。
三、直連與透過代理更新：避免失效節點造成循環
v2rayN 的訂閱選單通常提供「更新目前訂閱（不透過代理）」與「更新目前訂閱（透過代理）」兩種操作，實際名稱可能因版本而異。前者適用於可直接連線至訂閱網域的網路；若訂閱網址必須透過可用代理才能連線，則使用後者。請先在同一群組中分別手動測試，不要假設某種更新方式永遠適用。
最常見的循環是：目前節點已失效，但更新訂閱必須透過這個節點；要恢復節點，又得先更新訂閱。遇到這種情況，反覆點選透過代理更新並無法解決問題。請改用可連線的直連路徑，或切換至本機保留的其他可用節點，再進行更新。
- 先試直連：選擇不透過代理更新。若能成功，表示目前網路可連線至訂閱網址，平時更新可優先使用這條路徑。
- 再測代理：確認目前節點能連線至一般 HTTPS 網站後，再嘗試透過代理更新。核心正在執行，不足以證明節點可正常使用。
- 確認連接埠：前往「設定」→「參數設定」，查看本機監聽連接埠與監聽類型。若介面顯示 SOCKS 或混合連接埠為
10808，請依此核對記錄；這只是範例，不代表所有版本的預設值都相同。 - 排除外部網路接管：若直連更新仍異常，請檢查是否啟用了 TUN 或其他系統層級的網路接管。應用程式選擇直連，不一定能繞過系統層的流量攔截。
- 確認單一可用路徑：確認哪種方式可用後，再設定自動更新。不同版本是否會記住手動更新方式可能有所不同，不能把一次點選視為永久設定。
系統代理開關也不能取代上述測試。用戶端內部的訂閱請求可能採用獨立的網路設定，不一定沿用瀏覽器的代理路徑。若瀏覽器可以連線、用戶端卻不行，請比對兩者使用的節點、系統代理狀態與 DNS 路徑，不要先修改遠端伺服器的協定參數。
四、依錯誤訊息排查逾時、連接埠與憑證問題
錯誤原文比「更新失敗」更有助於排查。以下文字可能出現在用戶端記錄或底層請求錯誤中，前後也可能附有網址、連接埠或本地化說明。先找出關鍵字，再檢查對應階段。訂閱 HTTPS 憑證與節點傳輸使用的 TLS 憑證屬於不同連線，兩者不可混為一談。
Connection refused
原因與解法：目標連接埠拒絕連線。先確認目標是否為本機位址；若是 127.0.0.1，請檢查核心是否正在執行，以及代理監聽連接埠是否一致；若為遠端位址，則確認訂閱服務的連接埠是否可用。
The operation has timed out.
原因與解法：請求未能在限定時間內完成，可能卡在解析、連線或讀取階段。保持網址不變，分別測試直連與可用代理；若只有其中一條路徑失敗，請優先修復該路徑。
No such host is known.
原因與解法：網域名稱解析失敗。檢查訂閱網域的拼字與目前網路的 DNS 狀態；若瀏覽器運作正常，請確認瀏覽器是否使用獨立的安全 DNS，或透過代理進行解析。
The remote certificate is invalid because of errors in the certificate chain: NotTimeValid
原因與解法：憑證有效期限檢查失敗。先校正本機日期與時間；若時間正確仍出現錯誤，請聯絡服務方確認訂閱網站憑證是否已過期或尚未生效。
在 macOS 檢查時間與憑證
- 開啟「系統設定」→「一般」→「日期與時間」，確認是否已啟用自動設定日期與時間，並核對顯示的實際日期。只調整時區不一定能校正系統時鐘。
- 需要快速確認時，可在終端機執行
date -u查看 UTC 時間，並與可信的時間來源比對。 - 確認目前網路是否要求先完成網頁登入。公共網路的驗證入口可能回傳替代頁面，導致下載失敗或憑證異常。
- 若只有某個訂閱網域出現憑證錯誤，而其他 HTTPS 連線正常，請將已遮蔽敏感資訊的錯誤原文提供給服務方，檢查憑證鏈或網域設定。
五、下載成功卻沒有節點：檢查內容與群組
成功收到回應，只代表下載階段已完成。v2rayN 還必須識別內容並建立節點。常見訂閱內容可能是經過編碼的分享連結集合，也可能是用戶端支援的其他格式；不是任何 JSON、YAML 或網頁都能直接匯入。請選擇服務方明確標示適用於 v2rayN 的入口，不要只憑檔案副檔名判斷是否相容。
- 確認回應內容：如果內容開頭是
<!DOCTYPE html>或登入表單，請先處理網址、驗證或網頁檢查問題，不要把它當成節點編碼錯誤。 - 確認帳戶可用項目：帳戶過期、方案沒有可用節點，或服務方暫時移除線路，都可能導致訂閱回傳空內容。請以帳戶管理頁面與服務說明為準。
- 檢查篩選條件：清除節點搜尋欄，切換至目標群組，並檢查訂閱設定中的篩選規則。名稱篩選可能會讓下載成功後顯示的節點數變成零。
- 確認用戶端支援：若只有少數新型節點無法解析，請記下 v2rayN 完整版本號與匯入錯誤，再確認該版本是否支援相應的分享格式或參數。
- 區分匯入與連線：VLESS、VMess、Trojan 等節點已出現在清單後，連線失敗就屬於後續問題。更換 Xray 或其他核心，通常無法解決訂閱網址回傳網頁的狀況。
排查時不要先刪除整個訂閱群組。部分更新流程會依新內容同步節點，實際保留方式會因版本與設定而異。請先備份，再建立獨立的測試群組驗證新連結；確認節點數量與基本連線正常後，再替換原有網址。升級用戶端前也請記下目前版本與設定，避免將格式變更和網路變更混為一談。
六、自動更新間隔：先手動更新成功，再設定週期
自動更新只是定時執行相同類型的請求，無法自動修復失效權杖、憑證錯誤或無法連線的路徑。請先確認手動更新成功，再前往「訂閱群組」→「訂閱群組設定」，編輯目標群組的自動更新項目。若目前版本將開關放在全域設定中，請依實際介面設定，並確認各群組是否另有獨立週期。
| 使用情境 | 建議起始值 | 設定理由 |
|---|---|---|
| 線路穩定，日常使用 | 720 分鐘，也就是 12 小時 | 減少重複請求，同時定期同步節點變更 |
| 服務方經常調整節點 | 360 分鐘，也就是 6 小時 | 縮短同步等待時間，仍須遵守服務方的頻率限制 |
| 備用訂閱，偶爾使用 | 1440 分鐘，也就是 24 小時 | 維持低頻同步，使用前再手動確認一次 |
| 連續出現錯誤或收到 429 | 暫時停用自動更新 | 先排除問題，再依限流提示恢復更新週期 |
以上數值是設定建議，不是用戶端預設值，也不是速度測試結果。輸入前請先確認單位：欄位若以小時計，12 小時應填入 12；若以分鐘計，才填入 720。不要自行猜測 0 的意思，不同版本可能會將其視為停用或特殊設定，請使用介面明確提供的開關。
設定結果確認：以兩次成功記錄驗證自動更新
先記下一次手動更新成功的時間，再讓用戶端保持執行、電腦保持喚醒，觀察下一個排定週期是否產生成功記錄。電腦喚醒後沒有立即補跑，不能只憑這點判定訂閱失效。
筆電進入睡眠、用戶端結束執行，或系統暫停背景活動時，排程可能無法準時執行；恢復後是否補跑也可能因版本而異。若服務方剛重設權杖或緊急調整線路，直接手動更新一次即可，不必為了臨時同步而長期將週期縮短至 1 分鐘。
七、常見問題：更新方式與設定保留
訂閱更新逾時，是否代表所有節點都故障了？
不是。先使用現有節點連線至一般 HTTPS 網站，再單獨更新訂閱。若節點可用但訂閱逾時，請檢查訂閱網域、直連路徑與服務狀態，不要立刻清空節點清單。
透過代理更新失敗，不透過代理卻成功，該選哪一種？
先使用已確認可行的直連方式。接著檢查目前的代理節點與本機監聽連接埠。自動更新是否使用相同路徑，請以目前版本的設定與實際記錄為準，不能只看系統代理開關。
重新複製訂閱連結後，需要先刪除舊節點嗎？
請先備份，不必急著刪除。可以建立獨立的測試群組驗證新網址；確認節點能匯入並連線後，再替換原群組的訂閱網址，並清理不再需要的重複群組。
換個網路就能更新，還需要重新安裝 v2rayN 嗎？
先不要重新安裝。保持相同的訂閱網址，記錄兩個網路下的更新方式與錯誤差異，並優先檢查原網路的 DNS、驗證入口與存取限制。網路問題通常不會因重新安裝而改善。
Android 端也無法更新，可以照這個順序排查嗎？
連結、請求路徑、憑證與內容格式的排查順序可以沿用，但選單位置不同。v2rayNG 使用 Xray 核心，v2flyNG 使用 v2fly 核心；請分別確認是否支援訂閱格式，不要直接套用桌面版的本機連接埠或選單位置。
排查完成後，請保留一份不含憑證的簡短紀錄：用戶端版本、系統版本、失敗時間、HTTP 狀態或錯誤原文、成功的更新路徑，以及自動更新週期。下次遇到相同問題時，先比對最近一次成功紀錄，通常比從頭修改所有設定更容易找出原因。