MiniDumpWriteDump调用失败返回FALSE，需排查权限（如SeDebugPrivilege）、句柄有效性（用OpenProcess获取，禁用伪句柄）及参数正确性；GetLastError()返回5或6分别表示拒绝访问或句柄无效，空文件则检查路径权限、目录存在性及杀软拦截。
MiniDumpWriteDump 函数调用失败返回 FALSE 怎么排查
直接调用 MiniDumpWriteDump 却没生成文件，大概率是权限、句柄或参数三者之一出错。Windows 下必须确保目标进程可被调试（比如你有 SeDebugPrivilege 权限），且传入的 hProcess 是有效、未终止的句柄——用 OpenProcess(PROCESS_QUERY_INFORMATION | PROCESS_VM_READ, FALSE, pid) 获取，别用 GetCurrentProcess() 以外的伪句柄（如 -1）混用。
常见错误现象：GetLastError() 返回 5（拒绝访问）或 6（句柄无效）。如果 dump 文件为空或只有几十字节，说明写入中途失败，优先检查磁盘路径是否有写权限、目录是否存在、是否被杀软拦截。
- 确保已调用
SetErrorMode(SEM_NOGPFAULTERRORBOX)防止弹窗中断 dump 流程 - 不要在异常处理回调（如
SetUnhandledExceptionFilter）里直接调用MiniDumpWriteDump后再exit()—— 系统可能来不及刷盘，加个FlushFileBuffers()或短暂Sleep(10) -
MiniDumpType推荐从保守起步：MiniDumpNormal→MiniDumpWithIndirectlyReferencedMemory→ 最后才加MiniDumpWithFullMemory（体积大、慢、易失败）
DbgHelp.dll 加载和符号初始化容易漏哪几步
很多人只记得 MiniDumpWriteDump，却忘了 DbgHelp 的初始化不是“即用即查”。必须显式加载 dbghelp.dll（推荐延迟加载或 LoadLibrary），并调用 SymInitialize 设置符号路径，否则即使 dump 成功，后续用 WinDbg 分析时会缺模块、无堆栈帧。
关键点：调用 SymInitialize 时第二个参数传 NULL 表示用默认符号路径（_NT_SYMBOL_PATH 环境变量），但更稳妥的是拼一个本地缓存路径，比如 "srv*C:\symbols*https://msdl.microsoft.com/download/symbols"。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 必须在 dump 前调用
SymInitialize，且传入当前进程句柄（GetCurrentProcess()） - 若程序是 x64，必须用 x64 版本的
dbghelp.dll（System32 下）；x86 程序用 SysWOW64 下的版本——混用会导致SymInitialize返回 FALSE - 不需要调用
SymCleanup来“释放资源”，dump 完成后不依赖它继续运行
在 SEH 异常中安全触发 MiniDump 的注意事项
用 SetUnhandledExceptionFilter 捕获崩溃后生成 dump 是主流做法，但要注意：SEH 栈可能已损坏，不能分配新内存、不能调用多数 CRT 函数（如 fopen、malloc）、不能抛 C++ 异常。所有操作必须基于栈上已有的缓冲区或全局变量。
典型陷阱是试图在过滤器函数里拼接文件名用 sprintf 或 std::string —— 这些可能触发堆分配或调用被破坏的 DLL 导出函数，导致二次崩溃。
- 文件路径用静态数组存储，例如：
char szDumpPath[MAX_PATH] = {0}; sprintf_s(szDumpPath, "%s\crash_%lu.dmp", szBaseDir, GetTickCount()); - 打开文件必须用
CreateFile（非fopen），标志设为CREATE_ALWAYS | FILE_ATTRIBUTE_NORMAL，并检查返回值是否为INVALID_HANDLE_VALUE - 避免在过滤器中调用
MessageBox、OutputDebugString等可能重入的 API
MiniDump 文件太小或分析时看不到源码行号怎么办
dump 文件只有几 KB，或者 WinDbg 里 !analyze -v 显示 “IMAGE_NAME: unknown”、“STACK_TEXT: missing” —— 大概率是编译时没生成完整调试信息，或 dump 时没抓到关键内存段。
确认 PDB 文件与 EXE 匹配（用 dumpbin /headers your.exe | findstr "format" 查时间戳，再用 cvdump -a your.pdb 对比），同时检查 MiniDumpWriteDump 的 ExceptionParam 参数：如果是捕获异常场景，务必传入 EXCEPTION_POINTERS*，否则线程上下文（尤其是寄存器状态）会丢失。
- VS 编译选项必须开启：
/Zi（生成 PDB）+/DEBUG（链接时嵌入调试目录） - dump 类型至少选
MiniDumpWithThreadInfo | MiniDumpWithUnloadedModules，否则卸载的 DLL 模块信息会丢 - 如果程序用了 ASLR 或堆随机化，确保 dump 时没禁用
MiniDumpScanMemory相关标志（但慎用，它会显著拖慢 dump 速度）
最常被忽略的是：没验证 MiniDumpWriteDump 的返回值就直接退出进程，导致你以为“生成了”，其实函数根本没执行成功。每次调用后必须检查返回值，并用 GetLastError() 留痕。
