Skip to content

WSL VM 冷啟動異常緩慢 ​

1. 影響(對 wsldashboard 的影響) ​

以下問題都集中在 Windows 剛開機後(WSL VM 尚未預熱、處於冷啟動階段)觸發;VM 一旦熱起來,即恢復正常。

1.1 開啟軟體看不到發行版清單 ​

最直觀的影響:Windows 剛開機時開啟軟體,介面上的「發行版清單」看不到任何已安裝的發行版。

原因:wsldashboard 的發行版清單透過 wsl -l -v 列舉(src/wsl/ops/info.rs 中的 list_distros)。在 VM 冷啟動緩慢期間,wsl -l -v 同樣會進入「排隊等待 VM 就緒」的狀態(詳見下文「概述」中的對照表),導致:

  • 介面長時間空白,看不到任何已安裝的發行版;
  • 依賴該清單的後續操作(啟動/停止、連接埠代理同步、USB 掛載、狀態重新整理)隨之無法正常進行;
  • 使用者可能誤以為「發行版遺失」或「軟體異常」,實際只是查詢不到狀態,並非資料遺失。

等 VM 冷啟動完成後,重新整理或重新啟動軟體通常即可恢復。

1.2 /scheduler 啟動工作整體變慢(但最終會完成) ​

/scheduler 負責開機時的背景工作:發行版開機自動啟動、USB 自動連接、連接埠轉送啟用。在 VM 冷啟動緩慢期間,這些工作的每一步都需要等待 VM 就緒,導致:

  • 整體流程耗時從「秒級」拉長到「分鐘級」(與本機實測約 4.5 分鐘一致);
  • 表現上像「卡住不動」,但並非失敗——只要 VM 最終就緒,這些工作一定會完成(發行版會被拉起、USB 會掛載、連接埠轉送會落實)。

因此除非長時間(遠超 VM 冷啟動上限)仍未完成,否則無需介入,本質是在等 WSL 環境預熱。

2. 如何自我檢查是否中招 ​

核心思路:製造一次真正的冷啟動,然後為「第一次拉起發行版」計時。

方法 A:重新啟動 Windows 後立刻測試(建議) ​

  1. 重新啟動 Windows 11。
  2. 重新啟動完成後,立即開啟 PowerShell(系統管理員或一般皆可)。
  3. 執行:
powershell
Measure-Command { wsl -d Ubuntu -u root echo ok }

把 Ubuntu 換成你實際的發行版名稱(可用 wsl -l -q 查看)。

方法 B:wsl --shutdown 後冷啟動測試 ​

無需重新啟動系統,但效果等同冷啟動:

powershell
wsl --shutdown
Measure-Command { wsl -d Ubuntu -u root echo ok }

結果判定 ​

耗時結論
< 30 秒(通常 5~10 秒)正常,未中招
明顯 > 60 秒,甚至數分鐘中招,命中冷啟動緩慢問題

補充判據:執行上面的測試時,另一個終端機跑 wsl --version 若依然秒回,而 wsl -d ... 卻遲遲不返回,即可進一步確認慢點在 VM 冷啟動,而非 WSL 服務整體卡死。

3. 概述 ​

部分 Windows 版本 與部分 WSL 版本 的組合下,WSL 2 輕量型工具 VM(Utility VM)的冷啟動會異常緩慢——正常情況下拉起一個 Linux 發行版只需 5~10 秒,但在受影響環境中可能耗時數分鐘。

需要注意的是:這裡的「慢」發生在 VM 本體的冷啟動,而不是某個具體的 Linux 發行版啟動快慢,也不是 WSL 服務(LxssManager)本身卡死。可據此與一般故障區分:

命令是否需要 VM受影響環境下表現
wsl --version / wsl --status否秒回,正常
wsl -l -v / wsl -l -q --running 在 VM 啟動期間是阻塞數分鐘
wsl -d <distro> ...(第一次拉起)是阻塞數分鐘

4. 受影響環境(已知報告 / 已重現) ​

Windows 版本WSL 版本核心版本來源
Windows 11 25H2 10.0.26200.91682.7.126.18.33.2本機已重現
Windows 11 25H2 10.0.26200.91682.6.3—本機已重現(說明 WSL 版本不是唯一變數)
Windows 11 25H2 10.0.26200.89732.7.116.18.33.2microsoft/WSL#41253
Windows 11 25H2 10.0.26200.76232.7.06.6.114.1microsoft/WSL#14072
Windows 11 25H2 10.0.26200.84572.7.3—microsoft/WSL#40616

共同點:Windows 11 25H2(build 26200) 是最主要的觸發條件;多個 WSL 版本(2.6.3、2.7.x)上均有報告或重現。

5. 現象描述 ​

  1. 只在冷啟動時發生:剛重新啟動 Windows、或執行 wsl --shutdown 之後,第一次拉起任意發行版(VM 冷啟動)才會慢。
  2. 熱啟動正常:VM 已經運行時,wsl 系列命令基本秒回。
  3. 表現為「卡住」而非「報錯」:命令一直等不到返回,沒有明顯錯誤輸出。
  4. 連帶影響:VM 冷啟動期間,任何需要存取 VM 狀態的 wsl 命令(如另一個終端機裡的 wsl -l -v、wsl -l -q --running)都會跟著阻塞,因為它們都在排隊等待 VM 就緒。
  5. 典型耗時從正常的 5~10 秒 惡化到 數分鐘,偶發或穩定重現。

6. 相關連結 ​

7. 可能放大問題的因素(疑難排解建議) ​

已確認 WSL 版本不是唯一變數,因此同時關注以下機器層級設定(.wslconfig 位於 %USERPROFILE%\.wslconfig):

  • sparseVhd=false:關閉稀疏 VHD,虛擬磁碟固定配置、掛載更重,可能拖慢冷啟動。
  • memory=8GB + swap=4GB 等較大記憶體保留:冷啟動一次性保留大記憶體 + swap,主機記憶體吃緊時會觸發分頁,明顯拉長啟動時間。
  • dnsTunneling=true + autoProxy=true:網路堆疊初始化環節可能引入額外延遲。
  • 防毒軟體即時掃描 VHDX / VM 處理程序(部分環境出現過干擾)。

疑難排解/繞開建議 ​

  1. 先確認版本:wsl --version(若降級後仍顯示舊版本號,需 wsl --update 或重新啟動確認生效)。
  2. 暫時備份並清空 %USERPROFILE%\.wslconfig,wsl --shutdown 後重測冷啟動,觀察是否恢復。
  3. 若恢復,再逐條加回設定二分,鎖定具體那一行(優先懷疑 sparseVhd)。
  4. 若仍慢,考慮 Hyper-V / 虛擬機器平台冷啟動、防毒軟體排除 WSL 的 vhdx 與安裝目錄(C:\Program Files\WSL\)。

8. 結論 ​

冷啟動緩慢是環境層級問題,主要與 Windows 25H2(build 26200)相關,跨多個 WSL 版本重現;目前無法由應用層程式碼加速。對 wsldashboard 而言,能做的僅在排程鏈路中採用有界探測 + 並行輪詢 + 逾時降級,避免單次阻塞黑洞並保證業務最終正確落實,而不是去「加速」VM 本身。

該問題的根治需要由微軟 WSL 開發團隊修正底層 VM 冷啟動邏輯;應用側只能緩解與降級,無法從源頭解決。建議在上文「相關連結」中的 GitHub issue 跟進官方進展。

相關討論 ​