.NET 5 程序高级调试-WinDbg

上周和大家分享了.NET 5开源工作流框架elsa,程序跑起来后,想看一下后台线程的执行情况。抓了个进程Dump后,使用WinDbg调试,加载SOS调试器扩展,结果无法正常使用了:

0:000> .loadby sos clr

Unable to find module ‘clr’

这引起了个人的兴趣,必须要重新掌握.NET 5 / .NET Core 下WinDbg调试技能。那么,我们就开始吧:

一、先安装WinDbg

推荐的下载链接(老版本的WinDbg): https://raw.githubusercontent.com/EasyDarwin/Tools/master/Windbg_x86_x64/dbg_amd64.msi

如果各位想尝鲜,也可以从Windows Store下载 WingDbg Preview版本

下载后,一步一步安装即可。

启动后的界面:

二、安装最新版本的dotnet-sos

使用SOS调试器扩展,可以使用本地调试器(WinDbg、lldb)调试.NET Core 程序。

推荐大家详细学习参考这篇文档: dotnet-sos install

关于SOS调试器扩展,推荐大家看这篇链接: SOS调试器扩展

我们使用dotnet global tool 下载安装最新的 dotnet-sos Nuget包

dotnet tool install –global dotnet-sos

安装成功后,我们需要继续安装dotnet-sos

dotnet-sos install [–architecture ]

架构有以下选项:

  • Arm
  • Arm64
  • X86
  • X64

安装完成后,有这么一条提示:

Execute ‘ .load C:\Users\zhougq\.dotnet\sos\sos.dll ‘ to load SOS in your Windows debugger.

总结以下:WinDbg or cdb by running .load %USERPROFILE%\.dotnet\sos\sos.dll in the debugger.

原先我们使用.load by sos,在.NET Core 或者 .NET 5中需要直接按指定目录加载SOS调试器扩展了。

三、新建.NET 5应用,运行起来抓Dump

调试环境ready后,我们启动.NET 5 WinDbg调试了

首先我们找个.NET 5 Console应用(大家可以自己新建一个),这里我使用了上次研究elsa的测试工程了:

测试代码:

 1 using Microsoft.Extensions.DependencyInjection;
 2 using Microsoft.Extensions.Hosting;
 3 using Microsoft.Extensions.Logging;
 4 using System;
 5 using System.Threading.Tasks;
 6 using Elsa.Activities.Console.Activities;
 7 using Elsa.Activities.Console.Extensions;
 8 using Elsa.Activities.Timers.Extensions;
 9 using Elsa.Expressions;
10 using Elsa.Extensions;
11 using Elsa.Services;
12 using NodaTime;
13 
14 namespace ElsaRecurringTaskWorkflow
15 {
16     using Elsa.Activities.Console.Extensions;
17 
18     class Program
19     {        
20         static async Task Main(string[] args)
21         {
22             var host = new HostBuilder()
23                 .ConfigureServices(ConfigureServices)
24                 .ConfigureLogging(logging => logging.AddConsole())
25                 .UseConsoleLifetime()
26                 .Build();
27 
28             using (host)
29             {
30                 await host.StartAsync();
31                 await host.WaitForShutdownAsync();
32             }
33         }
34 
35         private static void ConfigureServices(IServiceCollection services)
36         {            
37             services             
38                 .AddElsaCore()
39                 .AddConsoleActivities()             
40                 .AddTimerActivities(options => options.Configure(x => x.SweepInterval = Duration.FromSeconds(1)))
41                 .AddWorkflow();
42         }
43     }
44 }

Run 跑起来:

在Windows 任务管理器中抓个Dump

四、使用WinDbg调试.NET 5 应用

在上一步中,我们抓了一个Dump文件:C:\Users\zhougq\AppData\Local\Temp\ElsaRecurringTaskWorkflow.DMP

我们打开Windbg

然后打开我们刚才抓的Dump文件:Open Dump File

首次打开会比较慢,WinDbg会尝试下载所需要的pdb调试符号,稍等一会即可。

下载复制完成后,我们就可以开始调试了:

首先,加载SOS扩展:

.load C:\Users\zhougq\.dotnet\sos\sos.dll

接下来,大家可以根据需要去不同的调试指令了,例如!runaway  !threadpool !syncblk等:

详细的WinDbg调试交差大家可以参考:

https://www.cnblogs.com/tianqing/p/11307049.html

[置顶] Windbg程序调试系列-索引篇

以上是使用WinDbg调试.NET 5的技术分享,下一篇将给大家继续分享Linux抓Dump分享的技能。

推荐几个不错的链接:

dotnet-sos install

SOS调试器扩展

周国庆

2021/1/17