linuxdeployqt打包的Qt应用在预装同版本Qt的机器运行报错如何解决

问题根因 #

该报错核心原因是应用运行时的库加载优先级/路径配置错误，即便目标机器Qt版本和打包机一致，也会因为路径优先级问题导致版本校验失败：要么加载了系统预装的Qt库触发冲突，要么打包的本地Qt库路径未被优先识别。

解决步骤 #

1. 编写专用启动脚本，强制优先加载本地部署库 #

不要直接运行./mpu，在部署目录/home/tmcp/user1/folder下新建启动脚本run_mpu.sh，内容如下：

#!/bin/bash
# 获取部署目录的绝对路径
APP_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" &>/dev/null && pwd)
# 本地库路径优先级调到最高，覆盖系统全局路径和用户环境变量配置
export LD_LIBRARY_PATH="$APP_DIR/lib":$LD_LIBRARY_PATH
# 禁用Qt全局插件扫描，避免加载系统预装Qt的插件
export QT_NO_PLUGIN_PATH=1
# 启动应用
"$APP_DIR/mpu"

给脚本添加执行权限：
chmod +x /home/tmcp/user1/folder/run_mpu.sh
后续所有场景都通过该脚本启动应用，禁止直接运行mpu二进制文件。

2. 新增qt.conf配置，锁定Qt资源路径 #

在部署目录/home/tmcp/user1/folder下新建qt.conf文件，强制Qt读取本地部署的资源，完全隔离系统预装Qt的路径：

[Paths]
Prefix = .
Libraries = lib
Plugins = plugins
Translations = translations
Binaries = .

3. 校验本地打包的Qt库正确性 #

执行以下命令确认打包进去的Qt库确实包含Qt_5.12版本标识：

cd /home/tmcp/user1/folder/lib
strings libQt5Core.so.5 | grep "Qt_5"

如果输出结果中没有Qt_5.12，说明打包时linuxdeployqt抓取了错误版本的Qt库，修复方法：

• 打包前先加载Qt 5.12.10的环境变量，执行qmake -v确认输出版本为5.12.10后，再重新用linuxdeployqt打包，替换现有lib目录下的文件。

4. 配置二进制RUNPATH（兜底方案） #

如果上述步骤仍未解决，可通过patchelf给mpu二进制硬编码运行时库查找路径，优先级高于所有环境变量配置：

# 没有patchelf先执行yum install patchelf安装
patchelf --set-rpath '$ORIGIN/lib' /home/tmcp/user1/folder/mpu

该配置会强制mpu优先从自身同级目录的lib子目录加载库，彻底规避系统Qt库的干扰。

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