You need to enable JavaScript to run this app. Win10下VirtualBox托管的Ubuntu18.04虚拟机中QtCreator调试触发SIGSTOP报错
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 12:15:08