QT5.13.2 MinGW环境反复出现GR-805:DX9 Overlay is DISABLED错误怎么办
QT5.13.2 MinGW(7.3.0) 环境 GR-805 : DX9 Overlay is DISABLED 报错处理方案
该报错本质是Qt图形渲染链路调用DX9组件异常导致,重装Qt只是重置了相关配置和链接文件,无需每次重装即可修复,可按以下优先级逐一验证处理:
1. 临时验证方案
- 运行应用时追加启动参数强制切换渲染后端,命令行运行时输入:
你的应用程序名.exe -platform windows:renderer=opengl
如果是在Qt Creator内运行,在项目的「运行配置」-「命令行参数」栏填入上述参数后重新启动即可。如果可正常启动,说明是默认DX9渲染后端适配问题,无需调整Qt安装文件。
2. 根源修复方案
- 清理Qt本地缓存:关闭所有Qt相关进程,进入用户目录下的
AppData\Roaming\QtProject路径,删除目录内所有缓存文件,重启Qt Creator后重新编译项目即可。 - 清理项目编译缓存:删除项目根目录同级的build-xxx构建输出文件夹,执行qmake后重新编译运行,排除旧编译产物的链接异常问题。
- 修复系统DX9运行库:按Win+R输入
dxdiag打开DirectX诊断工具,检查「显示」标签页下的DirectDraw、Direct3D加速功能是否全部启用,若存在异常重装DX9最终用户运行时即可。
3. 永久规避方案
如果上述验证确认是DX9渲染链路的兼容问题,可在项目代码中强制指定渲染后端,在main函数的QApplication实例化代码前添加一行配置:
QCoreApplication::setAttribute(Qt::AA_UseOpenGLES);
重新编译后应用会默认使用OpenGLES渲染,完全跳过DX9调用链路,不会再触发该报错。
内容的提问来源于stack exchange,提问作者kkhater
相关产品推荐
相关产品推荐

