dotnet 除錯應用啟動閃退的方法

應用程式如果啟動即閃退，那大部分時候日志模塊還沒初始化完成，很難通過應用自身的啟動流程了解到應用啟動失敗的原因，本文來告訴幾個不同的方法用來調查應用啟動失敗的原因

應用啟動失敗的原因可能有很多，例如系統環境問題，例如寫個點逗比代碼，例如呼叫某個帶毒的庫，如果應用啟動失敗，可以在開發環境上復現，那無疑是十分好的事情，因為咱可以使用開發環境強大的 VisualStudio 除錯工具進行除錯

使用 VisualStudio 除錯應用啟動失敗

在有符號的配合下，使用 VisualStudio 定位應用軟體啟動失敗在大多數時候都是比較輕松的，當然，沒有符號的話，也沒多少問題，至少可以快速定位到是哪個模塊

使用 VisualStudio 定位應用軟體啟動失敗的方法是讓 VisualStudio 啟動應用且進入除錯模式，做法就是隨便找一個 dotnet 6 的專案，當然，如果是所要除錯的應用的對應版本的代碼的專案那是最好的，點擊設定除錯屬性，設定應用作為啟動路徑

在 VisualStudio 2022 下，打開設定除錯屬性的界面可以是在專案上進行右擊，然后點擊屬性，找到除錯頁面，點擊打開除錯啟動組態檔即可看到，如下圖

接著點擊創建新組態檔，選擇可執行檔案

接下來選擇需要除錯啟動失敗的應用的路徑

為了同時捕獲一些本機例外，還請勾選“啟用本機代碼除錯”也就是混合除錯模式，本機例外包括 Window Runtime 拋出的例外，基礎的 Win32 呼叫包含的非回傳值的錯誤的例外，以及外部 C++ 等庫的例外等

為了提升除錯的成功率，還請在 VisualStudio 設定里面，將所有的例外都打開進行捕獲，同時關閉僅我的代碼除錯，打開所有例外捕獲的方法是在 除錯->視窗->例外設定 里面進行配置，簡單來說就是將能打鉤的全部打上，當然，你要是熟悉的話，那就少打鉤一些咯，反正多打鉤也沒啥問題

關閉僅我的代碼可以讓你除錯到一些被優化的代碼，在咱 dotnet 的程式集里面，對 Debug 下和 Release 下最大的不同在于勾選了優化代碼，如果勾選了僅我的代碼除錯，那將只除錯 Debug 生成的程式集，而默認忽略對 Release 的程式集的記錄，在大部分的除錯下，這個模式都可以減少發布的程式集的干擾，可以更加方便除錯業務代碼，但是當前是在除錯啟動失敗，啟動失敗可能是庫的鍋，需要除錯發布的程式集，推薦關閉僅我的代碼除錯，關閉的方法是在 VisualStudio 的 工具-> 選項 -> 除錯 里面，去掉 啟用“僅我的代碼” 的選項

完成配置之后，在 VisualStudio 里面，選擇剛才創建的新配置作為啟動項進行啟動

推薦是第一次除錯可以快速過，看看是不是有例外觸發，逐步去掉那些不影響啟動例外的干擾，嘗試找到導致啟動失敗的例外，即可進行快速定位

而啟動失敗還有一個隱藏的原因是寫了逗比代碼，自己退出的，那就需要自己進行除錯，找到是哪個模塊退出了應用，可以在第一次除錯的時候，通過輸出視窗找到應用的退出碼是多少，輔助定位邏輯，如果退出碼是一個零，那找找是不是存在 Environment.Exit(0); 類似的代碼，可以全域進行字串查找對應的代碼，或者是 Main 函式執行完成，例如在 WPF 里面呼叫了 Application.Current.Shutdown 進行退出

在開發環境上遇到應用啟動失敗，大部分時候都可以在 VisualStudio 的幫助下快速定位到為什么啟動失敗

但是如果應用只是在用戶的設備上才失敗，那就沒那么好玩了，接下來將告訴大家如何除錯用戶端的應用啟動失敗

使用 dnSpy 除錯應用啟動失敗

在用戶的設備上，如果應用啟動失敗了，如果此時應用自己的日志模塊還沒初始化完成，那也不用慌，系統的事件查看器可能可以幫忙到你，打開系統的事件查看器，里面也許記錄了一些應用啟動失敗的原因，例如是系統環境問題，比如是系統缺少了某個庫，或者是驅動問題，我之前很經常遇到的就是 WPF 應用啟動失敗是由顯卡驅動導致的，不過顯卡驅動問題基本上用不到多少的除錯，稍微看一下就能看到了，系統的各個部分都會很奇怪

如何打開系統的事件查看器？在 Win10 下，右擊開始選單按鈕，點擊事件查看器即可打開，打開之后，大部分時候都可以先去看 Windows 日志里面的應用程式的日志，里面也許有記錄應用的啟動失敗原因

但是有時候事件查看器記錄的也很迷，如下面例子的啟動失敗的記錄

系統記錄了兩條相關的錯誤日志，一條是 .NET Runtime 錯誤日志，如下內容

Application: KajijuniLiguqujokemka.exe
CoreCLR Version: 6.0.522.21309
.NET Version: 6.0.5
Description: The process was terminated due to an internal error in the .NET Runtime at IP 00007FF9DAEBDA03 (00007FF9DACF0000) with exit code c0000005.

另一條是 Application Error 日志，內容如下

錯誤應用程式名稱: KajijuniLiguqujokemka.exe，版本: 1.0.0.0，時間戳: 0x62571213
錯誤模塊名稱: coreclr.dll，版本: 6.0.522.21309，時間戳: 0x625708f4
例外代碼: 0xc0000005
錯誤偏移量: 0x00000000001cda03
錯誤行程 ID: 0x3814
錯誤應用程式啟動時間: 0x01d882fdfe019fc7
錯誤應用程式路徑: C:\lindexi\Code\lindexi\BeyajaydahifallChecheecaifelwarlerenel\KajijuniLiguqujokemka\bin\Debug\net6.0-windows\KajijuniLiguqujokemka.exe
錯誤模塊路徑: C:\Program Files\dotnet\shared\Microsoft.NETCore.App\6.0.5\coreclr.dll
報告 ID: 45232171-a61e-46fa-b80b-248ad12f5fef
錯誤程式包全名: 
錯誤程式包相對應用程式 ID: 

這兩條日志沒有能給咱很好的一個除錯思路，只能說明應用確實掛了而已，不能說明是應用自己寫了逗比代碼，也不能證明是系統環境問題，也不能證明是呼叫庫的問題，想要了解為什么，只能繼續往下進行除錯

通過 dnSpy 神器可以輔助在用戶端進行除錯，根本原因在于 VisualStudio 太龐大了，在用戶端安裝不太現實，但 dnSpy 是非常輕巧的，可以免安裝使用，相當于在用戶端跑一個輕巧的 VisualStudio 除錯工具

支持 dotnet 6 版本的 dnSpy 下載地址請看 支持 dotnet 6 的 dnSpy 神器版本

除錯的思路和上文的使用 VisuslStudio 除錯的差不多，有稍微一點不同的是，需要先將要除錯的 Exe 拖入到 dnSpy 中，然后點擊此 Exe 進行除錯，同樣需要勾選例外等

使用 dnSpy 除錯還有一個好處是，可以無須任何符號即可進行除錯，十分方便

使用 ProcDump 進行 DUMP 分析

但是如果應用的啟動失敗不是每次都復現的，是概率復現的，那就不好玩了，以上兩個方法都是需要進行除錯啟動的，而大家都知道，除錯模式下和非除錯模式下是有差別的，例如多執行緒執行的差別，如果剛好啟動是因為執行緒安全導致的問題，那么除錯下也許是復現不到的，對于不是每次都失敗的應用啟動，進行除錯是非常想砸鍵盤的，有時候除錯的好好的，應用就啟動成功了，有時候覺得沒問題，按下繼續，應用就啟動失敗了

或者是在用戶端，用戶有情緒了，不適合進行慢慢的除錯，此時可以用到 ProcDump 工具輔助，在應用啟動時候的時候，將失敗時做一個 DUMP 檔案，然后咱就可以將這個 DUMP 傳回開發的設備上慢慢進行分析

這個 ProcDump 是微軟極品工具箱的一個很有名的工具

官方下載地址： https://docs.microsoft.com/zh-cn/sysinternals/downloads/procdump

根據官方檔案可以了解到使用方法是在命令列使用如下引數，即可做到在應用因為例外掛掉自動捕獲 DUMP 檔案

procdump.exe -e -t -w -ma <行程名>

引數的含義如下

• -e : 當行程遇到未經處理的例外時寫入轉儲
• -t : 行程終止時寫入轉儲，如果應用啟動失敗是自己逗比或者某個庫逗比呼叫了退出行程的方法，那也可以使用捕獲到
• -w : 等待指定的行程啟動，大部分時候都是先運行 ProcDump 工具，然后再啟動應用，這樣 ProcDump 相當于監控應用啟動失敗或退出，如此即可采用 ProcDump 啟動行程除錯應用啟動閃退
• -ma : 獲取的是 Full Dump 檔案，也就是包含所有內容的 DUMP 檔案，雖然這個 DUMP 比較大，但是調試會根據方便，如果傳輸程序比較難，而且開發者也熟悉除錯 DUMP 可以換用 -mm 命名寫入小型 DUMP 檔案

假定需要除錯的啟動失敗的應用是 KajijuniLiguqujokemka.exe 應用，那么執行的命令如下

procdump.exe -e -t -w -ma KajijuniLiguqujokemka

如此即可在應用啟動閃退自動創建 DUMP 檔案，創建好的 DUMP 檔案可以采用 7z 工具壓縮一下再傳回開發機器，使用 7z 可以極大壓縮 DUMP 檔案，因為 DUMP 檔案里面很多資料都是全 0 的

拿到 DUMP 檔案之后，就需要開啟 DUMP 除錯了，最簡單的 DUMP 除錯是打開 VisualStudio 將 DUMP 檔案拖進入，然后如開始的步驟先配置一下，然后點擊使用混合進行除錯即可

核心是看呼叫堆疊，和區域變數視窗，找到是哪個模塊拋出例外或者退出，如果 VisualStudio 無法幫到你，那就只能換成 WinDbg 啦，不過這又是另外一個故事了

大家可以嘗試使用我放在 github 的代碼進行測驗

更多請看 dotnet 代碼除錯方法

博客園博客只做備份，博客發布就不再更新，如果想看最新博客，請到 https://blog.lindexi.com/

標籤：.NET技术

上一篇：洗掉查詢字串并將值附加到URL路徑

下一篇：WPF 使用 MAUI 的自繪制邏輯