dotnet test开启--blame-hang-timeout时如何禁用超大Hang Dump生成
挂起检测链路下的转储控制方案
提到的DUMP_TYPE相关配置属于.NET测试blame组件的内置环境变量能力,完全可以在不影响--blame-hang-timeout挂起检测逻辑的前提下,实现转储体积压缩甚至完全关闭转储生成。
方案1:保留转储排查能力,大幅压缩文件体积
默认配置下,挂起触发的转储为全量用户态内存转储,会完整抓取被测进程的全部内存内容,这就是生成文件能达到数GB的核心原因。
可以通过调整转储类型把体积压到可接受范围:
- 配置方式:设置环境变量
VSTEST_DUMP_TYPE,可选取值对应不同的转储采集范围:Mini:仅采集核心线程栈、模块加载信息、关键系统句柄,生成的文件通常在10MB~50MB区间,足够定位绝大多数常见的测试挂起问题Heap:仅采集托管堆相关的内存数据,文件体积约为全量转储的1/5Full:就是当前默认的全量转储,也就是大体积转储的来源
- 命令行调用示例:
Windows 临时设置环境变量运行测试:set VSTEST_DUMP_TYPE=Mini && dotnet test ... --blame-hang-timeout 2000
Linux/macOS 临时设置环境变量运行测试:VSTEST_DUMP_TYPE=Mini dotnet test ... --blame-hang-timeout 2000
如果是在CI流水线中执行测试,直接把这个环境变量配置到流水线任务的全局变量里即可,不需要修改测试项目代码。
方案2:完全禁用转储生成,零磁盘占用
blame 组件本身就提供了转储生成的总开关,不需要移除--blame-hang-timeout参数:
- 配置方式:设置环境变量
VSTEST_DUMP_ENABLED,将值设为0或false时,检测到测试挂起触发超时逻辑后,只会正常标记测试失败、输出挂起时刻的线程调用栈日志,不会在磁盘生成任何转储文件 - 命令行调用示例:
Windows 下执行:set VSTEST_DUMP_ENABLED=0 && dotnet test ... --blame-hang-timeout 2000
Linux/macOS 下执行:VSTEST_DUMP_ENABLED=0 dotnet test ... --blame-hang-timeout 2000 - 注意:这个开关仅控制转储文件的写入行为,不会影响挂起检测的核心逻辑——
--blame-hang-timeout依旧会按设定的时长监控测试运行状态,超时后正常中断挂起的测试进程。
常见配置排查点
- 上述环境变量从.NET 5.0版本开始原生支持,不需要额外安装全局工具或升级测试SDK版本
- 在.NET 6及更高版本环境下,可以直接用命令行参数替代环境变量,在原有测试命令后追加
--blame-hang-dump-type Mini即可实现迷你转储的效果,不需要额外设置环境变量 - 如果配置了转储类型后依然生成大体积文件,检查测试项目关联的
.runsettings配置文件,是否在<CollectDump>节点下硬编码了<DumpType>Full</DumpType>配置,把对应节点值修改为目标类型、或直接删除<CollectDump>节点即可生效
内容的提问来源于stack exchange,提问作者Timon Post
相关产品推荐
相关产品推荐

