Qt Creator中QML断点无法触发的调试配置问题求助

一、QML断点不触发的排查与修复 #

• 确认编译参数同步：检查项目.pro文件，确保已添加DEFINES += QT_QML_DEBUG和QT += qml debug。Qt Creator的“Qml debugging and profiling”UI配置有时会因手动修改.pro未同步，需手动补全这两项。
• 规范QML加载方式：避免用QQmlComponent动态加载QML（调试器难以映射断点），优先使用QQmlApplicationEngine::load()加载。确保QML文件要么以原始文件路径加载，要么正确加入qrc资源（不要用二进制压缩打包），保证调试器能定位到原始文件。
• 强制指定调试端口：在运行配置的“Arguments”中添加-qmljsdebugger=port:12345,block，同时在调试配置中指定端口12345。RHEL7防火墙可能拦截随机端口，固定端口可避免连接失败。
• 更换兼容GDB版本：RHEL7默认GDB 7.6对Qt 5.12 QML调试支持不足，改用Qt安装包自带的GDB（路径如~/Qt5.12.2/Tools/GDB/bin/gdb），在Qt Creator的“工具>选项>调试器>GDB”中指定该路径。

二、启动调试的断言警告与停止错误处理 #

• 调整ptrace权限：RHEL7默认限制进程ptrace权限，可联系管理员执行echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope临时放开；无sudo权限时，在main.cpp开头添加代码：

  #include <sys/prctl.h>
  int main(int argc, char *argv[]) {
      prctl(PR_SET_PTRACER, PR_SET_PTRACER_ANY, 0, 0, 0);
      // 后续原有代码
  }
  

  编译时需在.pro中添加LIBS += -lrt。
• 关闭自动调试配置：在Qt Creator调试配置的“Qt Quick”标签中，禁用“Auto-enable Qt Quick Debugging”，手动指定调试端口，避免自动探测引发的冲突。
• 清理编译缓存：删除项目build目录下所有文件，重新执行qmake、编译，修复损坏的调试符号文件导致的异常。

三、额外注意事项 #

• 确保Debug模式编译：检查.pro文件，确认CONFIG += debug且无CONFIG += release或QMAKE_CXXFLAGS += -O2等优化参数。Release模式下QML会被优化，断点无法触发。
• 验证运行时参数：启动程序时必须携带QML调试参数，Qt Creator调试模式会自动添加，但手动启动时需附加-qmljsdebugger=port:xxxx，否则调试器无法附着。

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