Qt Creator调试提示"Temporarily disabling breakpoints"断点失效问题

故障原因 #

• DLL对应的PDB调试符号不匹配：DLL重新编译后PDB未同步更新，或调试器加载了其他路径下的旧版PDB，导致断点和运行的DLL代码无法对应
• DLL为短生命周期动态加载：该DLL采用LoadLibrary加载、调用完成后立刻FreeLibrary释放的逻辑，你附加调试的时机晚于首次DLL加载事件，调试器未捕获到DLL加载通知，始终判定该DLL处于未加载状态
• 该DLL的编译配置变更：近期调整过该DLL的编译选项，关闭了调试信息生成、开启了编译器优化，或是切换为Release配置编译，导致调试器无法识别断点位置
• Qt Creator调试缓存异常：本地存储的旧断点缓存、模块加载缓存和新编译的DLL哈希不匹配，调试器误将正常加载的DLL判定为未加载
• 权限不匹配：运行主应用的进程权限和Qt Creator运行权限不一致（比如主应用是管理员权限运行，Qt Creator是普通用户权限启动），调试器无法读取该DLL的内存和符号信息

排查步骤 #

• 验证符号一致性：执行dumpbin /PDBPATH <你的DLL路径>命令查看DLL内置关联的PDB路径，确认对应路径下的PDB文件修改时间和DLL生成时间完全一致
• 调整调试附加时机：如果该DLL是调用时动态加载、用完即释放的模式，统一使用「Attach to Unstarted Application」模式附加调试，确保调试器能捕获到DLL的首次加载事件，正常关联符号
• 核对DLL编译配置：确认该DLL当前为Debug配置编译，MSVC工具链下开启了/Zi//ZI调试信息生成选项，MinGW工具链下开启了-g选项，同时未开启高阶编译器优化、未剥离符号表
• 清理缓存重试：关闭Qt Creator，删除项目对应的build-*临时生成目录，删除Qt Creator本地缓存目录（默认路径为%APPDATA%\QtProject\qtcreator）中的断点和模块缓存，重新编译整个项目后再尝试调试
• 统一运行权限：确保启动主应用的控制台、Qt Creator的运行权限一致，要么均为普通用户权限，要么均为管理员权限，避免权限差异导致符号读取失败
• 手动关联符号与源码：附加到进程后，在Qt Creator调试界面的「模块」列表中找到目标DLL，右键选择「加载符号」手动指定对应PDB文件；同时在调试设置中确认DLL的源码目录已添加到源码搜索路径中

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