使用windeployqt发布的QML应用在特定Win10 PC运行无UI显示

现有打包流程的疏漏 #

你的打包脚本存在几个容易触发UI加载失败的问题：

• 调用windeployqt时未加--release参数：Qt 5.14版本的windeployqt默认不会自动识别目标二进制是debug还是release版本，很容易混入debug版的Qt依赖、QML插件，这类debug依赖在未安装对应Qt开发环境的设备上会直接导致QML渲染引擎初始化卡死，表现就是进程在任务管理器驻留，无任何窗口弹出。
• 未显式指定图形渲染相关依赖：Qt 5.14的QML默认优先使用ANGLE渲染路径（将OpenGL ES调用转译为DirectX调用），你当前的执行命令不会主动完整拷贝ANGLE依赖的libEGL.dll、libGLESv2.dll、d3dcompiler_47.dll。部分Win10 Pro设备默认禁用桌面OpenGL兼容层、或者核显/独显的OpenGL驱动损坏时，ANGLE依赖缺失就会卡在渲染初始化阶段，UI无法加载。
• QML隐式依赖漏拷：如果QML代码中使用了QtQuick.Controls、QtGraphicalEffects、多媒体类模块，Qt 5.14版本的windeployqt仅靠--qmldir参数经常漏拷对应模块的qml缓存、样式资源，QML引擎加载主窗口文件失败时会直接终止渲染流程，不会弹出系统级错误提示，仅保留后台进程。
• 手动拷贝MinGW运行时的操作存在风险：你手动复制三个运行时dll的步骤可以完全移除，给windeployqt加--compiler-runtime参数就会自动拷贝版本完全匹配的libgcc_s_seh-1.dll、libstdc++-6.dll、libwinpthread-1.dll，手动拷贝如果误用了其他版本MinGW的dll，反而会触发ABI不兼容的诡异问题。

修正后的打包脚本 #

替换原有脚本后重新打包，再到异常设备上测试：

rmdir /S /Q install
mkdir install
copy "build\Desktop_Qt_5_14_2_MinGW_64_bit\Release\release\MyApp.exe" install
:: 增加release、编译器运行时、ANGLE、软件渲染后端参数，确保依赖拷贝完整
C:\Qt\5.14.2\mingw73_64\bin\windeployqt.exe --release --qmldir qml --compiler-runtime --angle --software-renderer install\MyApp.exe
pause

特定Win10 Pro设备的定向排查 #

如果重新打包后问题仅在那台设备上复现，属于设备本地环境问题，按以下顺序排查：

• 检查显卡驱动状态：Win10 Pro默认推送的通用显卡驱动经常不支持OpenGL 2.0以上版本，Qt 5.14 QML默认渲染路径要求OpenGL 2.0或ANGLE正常工作，安装对应显卡的官方正式版驱动即可解决。
• 强制软件渲染模式测试：在异常设备上给MyApp.exe创建快捷方式，在快捷方式目标路径末尾加空格和参数-platform windows:software后启动，跳过硬件加速环节，如果能正常显示UI，即可确认是图形驱动/硬件加速适配问题。
• 排查全局注入类软件：第三方安全软件、桌面美化工具、老旧版本的输入法会注入Qt平台插件的加载流程，导致平台插件初始化失败，临时退出这类软件后再启动测试。
• 检查系统缩放设置：如果该设备开启了150%以上的自定义缩放、且使用了非系统默认的自定义字体，Qt 5.14的QML在部分场景下会卡在DPI适配初始化阶段，将缩放改回100%后再测试。

调试技巧：可以在打包目录下新建qtlogging.ini文件，写入以下配置开启Qt本地日志输出，启动应用后会在同目录生成日志文件，直接定位具体加载失败的模块或文件，无需盲目排查：

[Rules]
*.debug=true
qt.qpa.*=true
qt.qml.*=true

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