QT5程序部署提示缺少Qt5系统库问题的解决方法 symbol lookup error /libQt5XcbQpa.so.5: undefined symbol:xxx

https://blog.csdn.net/qq_29852231/article/details/128853681

QT5程序部署提示缺少Qt5系统库问题的解决方法
问题：在用QT5.12开发程序后，部署至现场（Ubuntu18/20）发现提示缺少QT5的平台库（platform）或者系统提供的QT5平台库无法正常支撑程序运行
解析：经过研究发现，即时将Platform文件夹拷贝至程序同级目录，仍无法正常运行，通过对platform内的动态库的依赖检查发现可能是因为二级依赖查找到的库不全或版本不对导致。

解决方法
最简单的解决方法就是在部署环境中直接安装相应版本QT，但是作为商业产品，这种行为不可取，花费了大量时间，也撞了两次运气，终于找到了解决方法，如下。

首先需要将网上常说的，到指定路径寻找依赖的配置提前，越靠前越好：

QMAKE_LFLAGS += "-Wl,-Bsymbolic,-rpath,\'\$$ORIGIN\'"
QMAKE_LFLAGS += "-Wl,-Bsymbolic,-rpath,\'\$$ORIGIN/lib\'"
QMAKE_LFLAGS += "-Wl,-Bsymbolic,-rpath,\'\$$ORIGIN/../lib\'"
1
2
3
只有足够靠前，在编译链接时，程序第一寻找的第一链依赖的动态库路径才不是系统路径而是指定路径。
经试验，这段语句如果放在后面，程序第一寻找的QT平台库会去系统中找而非指定路径，这个应该与makefile的编译顺序有关。
通过脚本抓取程序第一链依赖的路径
脚本内容如下：

#bash ***.sh
#! bin/base
LibDir=$PWD/lib
mkdir $LibDir

Target=$1

lib_array=($(ldd $Target | grep -o "/.*" | grep -o "/.*/[^[:space:]]*"))

for Variable in ${lib_array[@]}
do
cp "$Variable" $LibDir
done
1
2
3
4
5
6
7
8
9
10
11
12
13
执行脚本语句为

sudo jiaoben.sh chengxu
1
脚本会将抓出的第一链依赖放入程序同级的lib文件夹中，再将QT安装路径下的5.12/gcc/plugins/platform文件夹拷贝至程序同级目录中，至此，程序所需的第一链依赖全部准备完成。

此时在实机环境部署仍有可能报错：

loaded library "/home/sinovel/S/platforms/libqxcb.so"
./S: symbol lookup error: /lib/x86_64-linux-gnu/libQt5XcbQpa.so.5: undefined symbol: _ZN22QWindowSystemInterface24setPlatformFiltersEventsEb, version Qt_5_PRIVATE_API
1
2
该问题为platform文件夹中QT平台动态库寻找到的依赖版本不对或缺失导致。
我们再将QT安装路径下的5.12/gcc/lib文件夹拷贝至程序所在目录的上级目录中，再启动即可正常启动。
放在上级目录的原因是，platform中的动态库QT官方在编译时第一指向即在上二层级中，放在程序所在目录上一级目录中即满足了platform中动态库的第一寻址路径，防止其从系统库中找寻版本不对的动态库甚至找不到动态库。

至此，程序可以正常部署运转。
————————————————

版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

原文链接：https://blog.csdn.net/qq_29852231/article/details/128853681