· 疑難排解 · 約 8 分鐘

v2rayN 一開就閃退?.NET 執行階段、資料夾權限與設定檔疑難排解

雙擊後視窗一閃即消失?依序檢查 .NET 桌面執行階段是否已安裝、程式資料夾是否有寫入權限,以及設定檔是否損毀;另說明 Android 閃退的處理方式。

本文重點

在 Windows 上,先確認 v2rayN 程序是否已結束,再從啟動記錄判斷是缺少執行階段、無法寫入資料夾,還是讀取設定檔失敗。若升級後才開始閃退,請保留舊資料夾,使用相同版本在新資料夾中以空白狀態啟動。Android 端則先分辨是應用程式退出,還是點選連線後 VPN 服務停止。

確認 v2rayN 是否真的已退出

視窗消失不代表程序已當機。先展開 Windows 工作列通知區域,按右鍵點選 v2rayN 圖示,嘗試開啟主畫面;也可以按 Ctrl + Shift + Esc,在工作管理員的「詳細資料」中查看 v2rayN.exe 是否仍在執行。若程序仍在,但畫面沒有回應,請記錄為介面無回應,不要誤判為缺少執行階段而反覆安裝。

程序狀態啟動記錄執行階段架構資料夾權限設定隔離

確認 .NET 桌面執行階段與程式架構

若 Windows 版本的程式依賴本機 .NET,請先確認錯誤訊息要求的架構名稱、版本與架構類型。若 WPF 版本要求 Microsoft.WindowsDesktop.App,即使已安裝 Microsoft.NETCore.App,也不代表桌面架構已安裝。自包含版本會隨套件附帶執行階段;若解壓縮不完整,請重新解壓縮整個套件,而不是逐一補上系統 DLL。

dotnet --list-runtimes

在 PowerShell 中執行上方命令。假設錯誤訊息要求 x64 的 Microsoft.WindowsDesktop.App 8.0.0,請確認 x64 執行階段中是否有符合需求的 8.0 系列桌面架構,不要看到任何一筆 .NET 記錄就略過檢查。此處的版本僅用來示範如何解讀錯誤,並不代表所有 v2rayN 版本都有相同需求。命令只會列出目前呼叫的 dotnet 所能找到的執行階段;若電腦同時安裝 x86 和 x64,請以錯誤訊息中的架構及執行階段搜尋位置為準。若命令找不到執行階段,也不能只據此判定系統未安裝執行階段。

錯誤訊息:You must install or update .NET to run this application.

原因:目前的程式找不到符合需求的 .NET 架構。解決方式:依照提示中的 Framework、Architecture 和版本需求,安裝對應的執行階段,再使用同一份程式重新測試。

錯誤訊息:System.UnauthorizedAccessException

原因:程式存取某個檔案或資料夾時遭到拒絕。解決方式:先查看事件詳細資料中的實際路徑;若寫入目標確實位於程式資料夾內,請使用相同版本,在目前帳戶可寫入的新資料夾中重新測試。

確認資料夾權限並隔離舊設定

先在記錄所指向的資料資料夾中,使用目前帳戶建立一個空白文字檔,儲存後再刪除。若測試失敗,表示目前帳戶至少無法在該位置完成這項操作;即使測試成功,也只證明能寫入這個檔案,無法排除現有資料庫設為唯讀、遭其他程序占用,或受到個別存取限制。不要為了啟動程式而大量變更系統資料夾權限。

  1. 結束程式並備份

    從通知區域的右鍵選單結束程式,確認工作管理員中的舊程序已結束,再備份舊解壓縮資料夾及另行指定的資料位置。用戶端仍在執行時,不要只複製單一資料庫檔案。訂閱連結和節點憑證請留在本機備份中。

  2. 解壓縮至新資料夾

    從原始安裝套件完整解壓縮相同版本。例如在檔案總管網址列輸入 %LOCALAPPDATA%,並在開啟的位置建立 v2rayN-test 資料夾。不要直接從壓縮檔中雙擊執行,也不要將新套件覆蓋到舊資料夾。

  3. 測試空白啟動

    不要複製舊資料,直接執行新資料夾中的 v2rayN.exe,並以一般使用者帳戶重新測試。若目前版本會從共用位置讀取使用者資料,單純更換程式資料夾不代表空白啟動;請先依據記錄確認實際資料路徑,備份後再暫時移開相應資料。

  4. 分批還原

    空白啟動成功後,優先使用原始訂閱網址重新匯入,再還原自訂設定。每還原一批,就結束程式並重新開啟一次。若只有還原某一批後問題再現,請將排查範圍縮小至該批資料;不要一次將舊版本的設定、資料庫和核心全部覆蓋到新資料夾。

排查 Android 閃退與 VPN 服務停止

v2rayNG 使用 Xray 核心,v2flyNG 使用 v2fly 核心。這兩款 Android 用戶端都不依賴 Windows 的 .NET 桌面執行階段。請記錄問題是在點選圖示、匯入設定,還是點選連線後發生,再判斷要檢查應用程式啟動,或 VPN 授權。

閃退疑難排解常見問題

已安裝 .NET,為什麼仍提示缺少執行階段?

請對照錯誤視窗要求的架構名稱、版本和架構類型。特別留意是否只安裝一般執行階段,或安裝了 x86 桌面執行階段,卻啟動 x64 版本。安裝後直接從解壓縮資料夾執行,避免舊捷徑影響判斷。

只有以管理員身分執行才能開啟,需要一直這樣使用嗎?

先以一般使用者帳戶,在可寫入的資料夾中測試相同版本。若能啟動,請優先移動資料資料夾,或修正特定路徑的權限。一般介面啟動和啟用 TUN 所需的系統權限是兩回事,不必長期以較高權限執行來迴避日常寫入問題。

空白啟動也失敗,回報問題時應提供哪些資訊?

請提供系統版本、套件檔名、程式架構、問題重現時間及第一筆相關錯誤,並註明是否使用相同版本在新資料夾中重新測試。分享記錄前,請遮蔽訂閱網址、存取權杖、節點憑證,以及包含使用者名稱的本機路徑;不要直接上傳整個設定資料夾。

用戶端下載與安裝