| 学习路线指引（点击解锁） | 知识定位 | 人群定位 |
|---|---|---|
| 🧡 Python实战微信订餐小程序 🧡 | 进阶级 | 本课程是python flask+微信小程序的完美结合，从项目搭建到腾讯云部署上线，打造一个全栈订餐系统。 |
| 💛Python量化交易实战💛 | 入门级 | 手把手带你打造一个易扩展、更安全、效率更高的量化交易系统 |
今天在浏览张队转载文章的留言时，遇到一个读者问了这样的问题，如下图所示：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-d8yNtFfJ-1667363719710)(https://incerry-blog-imgs.oss-cn-hangzhou.aliyuncs.com/image-%e5%a6%82%e4%bd%95%e5%9c%a8dotNet%e7%a8%8b%e5%ba%8f%e5%b4%a9%e6%ba%83%e6%97%b6%e8%87%aa%e5%8a%a8%e5%88%9b%e5%bb%baDump%ef%bc%9f-221031150512146.png)]
首先能明确的一点是"程序崩溃退出了是不能用常规的方式dump的"，因为整个进程树都已经退出。现场已经无法使用常规的方式读取到。
一般来说常规的方法是没办法读取到的，也有一些特殊的方式，比如有关部门在调查取证时，就可以通过一些工具读取到内存中的信息。当然这是一些hack手段，不在本文讨论中。
不过好消息是，虽然您无法在程序崩溃退出以后创建Dump，但是您可以在程序崩溃时自动创建Dump，这样下次遇到程序崩溃，那么就可以有分析的现场了。
在 Windows 中，可以将 Windows 错误报告 （WER） 配置为在应用程序崩溃时生成转储。
这个方式对所有程序都有效果，不仅仅是.NET程序，如C++、Go等等都可以；而且和.NET、.NET Core版本无关
regedit.exeHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumpsDumpFolder 类型为REG_EXPAND_SZ用于配置存放Dump文件的目录DumpCount 类型为REG_DWORD配置Dump的总数量当然也可以使用PowerShell命令来配置这些：
New-Item -Path "HKLM:\SOFTWARE\Microsoft\Windows\Windows Error Reporting" -Name "LocalDumps"
New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps" -Name "DumpFolder" -Value "%LOCALAPPDATA%\CrashDumps" -PropertyType ExpandString
New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps" -Name "DumpCount" -Value 10 -PropertyType DWord
按照上面的配置，如果程序发生了异常退出，那么就会在%LOCALAPPDATA%\CrashDumps目录创建程序的Dump。如下图所示：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-FYvTytKS-1667363719715)(https://incerry-blog-imgs.oss-cn-hangzhou.aliyuncs.com/image-%e5%a6%82%e4%bd%95%e5%9c%a8dotNet%e7%a8%8b%e5%ba%8f%e5%b4%a9%e6%ba%83%e6%97%b6%e8%87%aa%e5%8a%a8%e5%88%9b%e5%bb%baDump%ef%bc%9f-221031153658318.png)]
那么如果您是.NET Core跨平台应用，那么在Linux、MacOS等操作系统上，有更简单和更丰富的方式，下方有一些环境变量的参数：
COMPlus_DbgEnableMiniDump 或 DOTNET_DbgEnableMiniDump: 如果设置为 1，则发生故障时启用CoreDump生成。默认值为：0COMPlus_DbgMiniDumpType 或 DOTNET_DbgMiniDumpType: 要收集的转储类型。 有关详细信息，请看下文的说明。默认值为：2COMPlus_DbgMiniDumpName 或 DOTNET_DbgMiniDumpName: 写入转储的文件路径。 确保运行 dotnet 进程的用户具有指定目录的写入权限。默认值为：/tmp/coredump.COMPlus_CreateDumpDiagnostics 或 DOTNET_CreateDumpDiagnostics: 如果设置为 1，则启用转储进程的诊断日志记录。默认值为：0COMPlus_EnableCrashReport 或 DOTNET_EnableCrashReport：（需要.NET 6 或更高版本，目前仅Linux和MacOS可用）如果设为 1，运行时会生成 JSON 格式的故障报表，其中包括有关故障应用程序的线程和堆栈帧的信息。 故障报表名称是追加了 .crashreport.json 的转储路径/名称。COMPlus_CreateDumpVerboseDiagnostics 或 DOTNET_CreateDumpVerboseDiagnostics：（需要 .NET 7 或更高版本）如果设为 1，则启用转储进程的详细诊断日志记录。COMPlus_CreateDumpLogToFile 或 DOTNET_CreateDumpLogToFile：（需要 .NET 7 或更高版本）应写入诊断消息的文件路径。 如果未设置，则将诊断消息写入故障应用程序的控制台。对于这些环境变量，.NET 7 标准化前缀
DOTNET_，而不是COMPlus_。 但是，COMPlus_前缀仍将继续正常工作。 如果使用的是早期版本的 .NET 运行时，则环境变量仍应该使用COMPlus_前缀。
关于DOTNET_DbgMiniDumpType的说明如下所示：
Mini 小型Dump，其中包含模块列表、线程列表、异常信息和所有堆栈。Heap 大型且相对全面的Dump，其中包含模块列表、线程列表、所有堆栈、异常信息、句柄信息和除映射图像以外的所有内存。Triage 与 Mini 相同，但会删除个人用户信息，如路径和密码。Full 最大的转储，包含所有内存（包括模块映像）。一般情况下，我们会配置下面的环境变量：
DOTNET_DbgEnableMiniDump = 1
DOTNET_DbgMiniDumpName = [有权限的Path目录]
DOTNET_CreateDumpDiagnostics = 1
DOTNET_EnableCrashReport = 1
我们写一段代码来试一把，如下有一段代码首先输出了当前DTONET_前缀对的环境变量，然后抛出一个异常。
using System.Collections;
foreach (DictionaryEntry environmentVariable in Environment.GetEnvironmentVariables())
{
if(environmentVariable.Key.ToString()?.StartsWith("DOTNET\_") == false) continue;
Console.WriteLine($"{environmentVariable.Key}={environmentVariable.Value}");
}
throw new Exception("Crash");
然后编写一个run.bat脚本，用于设置环境变量顺便启动我们的程序。
@SET DOTNET_DbgEnableMiniDump=1
@SET DOTNET_DbgMiniDumpName="G:\Temp\CrashDump\CrashDump\bin\Debug\net6.0\dump.dmp"
@SET DOTNET_CreateDumpDiagnostics=1
@SET DOTNET_EnableCrashReport=1
@CrashDump.exe
运行run.bat可以看到环境变量正确的读到了，另外也成功的生成了Dump。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-q6IV4JGw-1667363719717)(https://incerry-blog-imgs.oss-cn-hangzhou.aliyuncs.com/image-%e5%a6%82%e4%bd%95%e5%9c%a8dotNet%e7%a8%8b%e5%ba%8f%e5%b4%a9%e6%ba%83%e6%97%b6%e8%87%aa%e5%8a%a8%e5%88%9b%e5%bb%baDump%ef%bc%9f-221031161241594.png)]
最后在对应的目录下，也生成了Dump文件。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-n1oYQ6Kk-1667363719718)(https://incerry-blog-imgs.oss-cn-hangzhou.aliyuncs.com/image-%e5%a6%82%e4%bd%95%e5%9c%a8dotNet%e7%a8%8b%e5%ba%8f%e5%b4%a9%e6%ba%83%e6%97%b6%e8%87%aa%e5%8a%a8%e5%88%9b%e5%bb%baDump%ef%bc%9f-221031163355806.png)]
如果是在容器环境中的话，直接修改Dockerfile即可，如下所示的那样：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-R3axc7iN-1667363719719)(https://incerry-blog-imgs.oss-cn-hangzhou.aliyuncs.com/image-%e5%a6%82%e4%bd%95%e5%9c%a8dotNet%e7%a8%8b%e5%ba%8f%e5%b4%a9%e6%ba%83%e6%97%b6%e8%87%aa%e5%8a%a8%e5%88%9b%e5%bb%baDump%ef%bc%9f-221031155128824.png)]
如果在容器环境中，DOTNET_DbgMiniDumpName需要配置映射到Host的目录，不然容器退出，Dump文件也会随之消失。
本文主要是介绍了如何在dotNet程序崩溃时自动创建Dump，Windows上的方法对于.NET Freamwork和.NET Core版本都适用。.NET Core全平台版本的话需要注意环境变量支持的.NET版本。