Windows 分析调试工具

目的

Windows 下调试定位 TDengine TSDB 崩溃问题指引手册。

查找 dmp 文件

taosd.exe 进程在崩溃发生时，会捕获崩溃，并在其所在目录下生成 .dmp 文件，文件名以 taosd 开头，中间为崩溃时间，如 “taosd_20260509_124419.dmp”，大小一般在 10M ~ 200M 之间。

注意： 若有 dmp 文件大小为 0K，可能存在严重堆栈被破坏情况。

未生成 dmp 文件

若上一步中未生成 dmp，可能崩溃无法从进程内捕获，需启动进程外捕获 dmp。

把以下内容保存为 .reg 文件，双击 .reg 文件导入至注册表中，开启进程外捕获 dmp：

Windows Registry Editor Version 5.00

; Enable WER out-of-process dump for taosd.exe
; Dumps are written by WerFault.exe (a separate process) and are therefore
; immune to stack/heap corruption in taosd.
;
; Usage:
;   1. Double-click this file, or run:
;        reg import wer_localdumps.reg
;   2. Make sure C:\TDengine\core\ exists and is writable by NETWORK SERVICE.

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps\taosd.exe]
; Directory where WerFault.exe writes the .dmp files (must exist before crash)
"DumpFolder"="C:\\TDengine\\core\\"
; DumpType 2 = MiniDumpWithFullMemory (full user-mode dump, best for debugging)
"DumpType"=dword:00000002
; Keep at most 10 dumps (oldest is deleted when limit is exceeded)
"DumpCount"=dword:0000000a

; Suppress the "taosd.exe has stopped working" dialog on server environments.
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting]
"DontShowUI"=dword:00000001

配置项说明：

DumpCount：10 生成 dmp 文件数上限，超过后会删除最旧的 dmp 文件。
DumpFolder：C:\TDengine\core\ 存放 dmp 文件的目录。

PDB 文件获取

崩溃栈需结合 PDB 文件方可定位函数名及行号，提供以下方式获取 PDB 文件：

社区版用户：官方下载链接：https://www.taosdata.com/symbols/，选择对应版本号下载 PDB 文件。
企业版用户：暂未提示供下载，需联系 TDengine 技术支持获取。
自己编译版本：PDB 文件与编译输出的可执行文件在同一目录下。

使用 ASAN 版本

若 dmp 无法定位问题，需进一步升级，启用 ASan 版本调试。

目前 TDengine 仓库 Debug/Release 都支持编译 ASAN 版本，编译选项与 LINUX 相同。

说明： Windows 下的 ASAN 不支持内存泄露检查功能，但越界访问及 Use-after-free 都支持。

版本编译

编译选项： -DBUILD_SANITIZER=true。
DEBUG 版本： VS 2022 任意版本都可编译。
RELEASE 版本：VS 2022 >= 17.14.32。

前置条件

在目标机器上运行 ASan 版本的 TDengine，需要把编译机上的 ASan 动态库复制到用户机器上。

动态库在编译机上位置（VS 2022）：

C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.44.35207\bin\Hostx64\x64\

构建类型	需随包的 DLL	复制目标位置
Release + ASan	clang_rt.asan_dynamic-x86_64.dll	放到 taosd 同目录下
Debug + ASan	clang_rt.asan_dbg_dynamic-x86_64.dll	放到 taosd 同目录下

MSVC ASan 报告输出位置

默认输出：stderr

ASan 报告默认写到 stderr。具体去哪取决于运行方式：

运行方式	默认输出位置
命令行直接运行 taosd.exe	直接打印到当前终端窗口
双击运行（无控制台）	丢失（无窗口，stderr 无处输出）
作为 Windows 服务运行	丢失（服务无 stderr 控制台）

把 ASan 报告输出到文件（避免丢失）

设置环境变量 ASAN_OPTIONS，在启动 taosd 之前：

# 加上进程名，便于区分多进程场景
set ASAN_OPTIONS=log_path=C:\TDengine\log\asan_report:log_exe_name=1
taosd.exe

生成文件名格式：asan_report.12345（PID 后缀）或 axsan_report.taosd.exe.12345。

性能对比

taosBenchmark 创建 1W 子表，每子表 1W 的智能电表数据

说明： DEBUG 版本大量写入数据会崩溃（已知编译的问题），暂无法测试

	写入性能	对比
Release 版本	204 秒	基准
Release + ASan 版本	324 秒	增加 50%

ASan 检测效果图

测试代码段：

void test() {
    char buf[4];
    // overflow
    memcpy(buf, "abcdefg01234", 8);
}

检测结论：

ASan 成功检测到越界访问，报告如下：

==12345==ERROR: AddressSanitizer: stack-buffer-overflow on address 0x7ffde5c1f8f0 at pc 0x0000000000000 bp 0x7ffde5c1f8a0 sp 0x7ffde5c1f890
READ of size 8 at 0x7ffde5c1f8f0 thread T0
    #0 0x000000000000 in test() (taosd.exe+0x000000000000)
    #1 0x000000000000 in main (taosd.exe+0x000000000000)
Address 0x7ffde5c1f8f0 is located in stack of thread T0 at offset 48 in frame
    #0 0x000000000000 in test() (taosd.exe+0x000000000000)
  This frame has 1 object(s):
    [32, 36) 'buf' <== Memory access at offset 48 overflows this variable
HINT: this may be a false positive if your program uses some custom stack unwind mechanism or swapcontext
      (longjmp and C++ exceptions *are* supported)
SUMMARY: AddressSanitizer: stack-buffer-overflow in test() (taosd.exe+0x000000000000)