Win10下VirtualBox托管的Ubuntu18.04虚拟机中QtCreator调试触发SIGSTOP报错
虚拟环境下QtCreator调试触发SIGSTOP报错的原因与解决方法
复现场景
- 运行环境:Windows 10宿主机通过VirtualBox托管Ubuntu 18.04虚拟机,使用QtCreator 4.13.1(基于Qt 5.15.1构建)调试C++程序
- 触发规律:项目设置勾选
Run in Terminal选项后启动调试,立刻弹出The inferior stopped because it received a signal from the operating system. Signal name: SIGSTOP报错 - 已验证排除的变量:更换多版本QtCreator、不同版本GDB、多份不同代码版本均无法消除该报错;直接在gnome-terminal独立运行程序可正常执行
根因分析
- 终端启动流程的信号处理逻辑冲突
勾选Run in Terminal后,QtCreator的调试链路为:先拉起指定终端模拟器,再由GDB将被调试程序附着为终端的子进程。在终端从初始化状态切换到执行用户程序的阶段,终端父进程会向子进程发送临时SIGSTOP做启动状态同步——这类临时信号本应被GDB自动识别、直接放行,不会中断调试流程。但QtCreator 4.13.x版本的GDB封装层存在兼容缺陷,没有将该类初始化阶段的SIGSTOP加入自动放行的信号白名单,直接把系统拦截的信号抛出为调试中断事件。
手动独立运行程序时,不存在GDB作为信号中间拦截层,SIGSTOP作为临时同步信号会被内核在调度阶段自动唤醒,因此不会触发报错。 - VirtualBox 兼容层的信号穿透问题
安装Guest Additions的Ubuntu 18.04虚拟机环境中,gnome-terminal与VirtualBox虚拟显卡的渲染逻辑存在适配bug:原本用于暂停终端窗口刷新的SIGSTOP信号,会直接从终端主进程穿透到所有子进程,没有被终端进程本身做拦截过滤。
可落地解决方法
- 绕开QtCreator自动拉起终端的调试链路:先手动打开独立的gnome-terminal窗口,在窗口中启动GDB加载目标程序,再通过QtCreator的“Attach to Running Process”功能附着到对应的GDB进程完成调试,完全规避QtCreator的终端拉起逻辑。
- 修改GDB自动信号处理规则:在QtCreator的调试器启动配置中,为GDB添加初始执行命令
handle SIGSTOP stop nopass,让GDB收到SIGSTOP信号时自动放行,不中断调试流程。 - 替换QtCreator默认调用的终端:在QtCreator的系统环境设置中,把默认终端从gnome-terminal更换为xfce4-terminal,规避VirtualBox环境下gnome-terminal的信号穿透bug。
内容的提问来源于stack exchange,提问作者UbuntuUser
相关产品推荐
相关产品推荐

