C++ DLL热重载时新版本PDB调试符号无法加载问题

MSVC调试器的符号缓存键默认取DLL的模块基名（即DLL文件名本身，不包含路径），当DLL通过FreeLibrary卸载后，调试器不会立刻清除该基名对应的符号绑定记录。
你的场景触发逻辑是：

• 首次加载TheName.dll时，调试器无对应基名的符号缓存，会正常读取PE头里修补后的PDB路径TheName.a.pdb，校验GUID、Age匹配后加载符号，流程正常。
• 卸载旧DLL、替换新编译的DLL、将PE头PDB路径修改为TheName.b.pdb后再次加载同基名的TheName.dll时，调试器会直接复用第一次绑定的TheName.a.pdb符号缓存，完全不会读取新DLL头中更新后的PDB路径。
• 新编译DLL对应的PDB GUID、Age和旧的TheName.a.pdb完全不匹配，调试器就会抛出“已加载不同版本符号”的错误，拒绝加载新PDB。

还有两个容易被忽略的触发点：

• 如果旧DLL没有被真正卸载（比如全局工作线程未退出、其他模块持有DLL句柄、全局资源未释放导致FreeLibrary后引用计数不为0），Windows DLL加载器会直接返回已加载的旧DLL句柄，根本不会加载你新编译的文件，也会触发同类符号错误。
• 如果你修改PDB路径时意外覆盖了字符串末尾的\0终止符，会导致调试器读取到乱码路径，但你首次加载正常，基本可以排除这个问题。

• 成本最低的方案：每次复制DLL到中间目录时，给DLL文件名本身加和PDB对应的版本后缀，比如TheName_a.dll、TheName_b.dll，同步修改PE头里的PDB路径为对应名称，保证每次加载的模块基名唯一，调试器会将其识别为全新模块，正常加载对应PDB。
• 如果不想修改DLL文件名，可以在VS调试设置里开启「动态加载模块时强制重新扫描符号」选项，同时关闭符号缓存的持久化，但不同VS版本选项位置有差异，且自动化热重载场景下稳定性不如改文件名的方案。
• 也可以在热重载逻辑里主动调用SymUnloadModule64接口通知调试器卸载对应模块的符号，但需要自行对接调试符号API，实现复杂度更高。

内容的提问来源于stack exchange，提问作者Dess