Ubuntu 22.04+Qt6.5.2加载xcb平台插件失败问题求助

问题分析 #

错误提示显示xcb平台插件已被找到但无法加载，这通常是插件依赖的系统库缺失，或Qt环境变量配置不完整导致的。

解决方案 #

1. 检查xcb插件的依赖缺失 #

运行以下命令查看libqxcb.so的依赖情况，定位缺失的系统库：

ldd /home/username/Qt/6.5.2/gcc_64/plugins/platforms/libqxcb.so | grep "not found"

2. 安装缺失的系统依赖包 #

根据上述命令输出的缺失库，安装对应的Ubuntu系统包。以下命令覆盖多数常见缺失场景：

sudo apt install libxcb-xinerama0 libxcb-cursor0 libxcb-randr0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-render-util0 libxcb-shape0 libxcb-xkb1 libxkbcommon-x11-0

3. 配置完整的Qt环境变量 #

除平台插件路径外，需确保Qt核心库路径加入系统库搜索路径：

export LD_LIBRARY_PATH=/home/username/Qt/6.5.2/gcc_64/lib:$LD_LIBRARY_PATH
export QT_QPA_PLATFORM_PLUGIN_PATH=/home/username/Qt/6.5.2/gcc_64/plugins/platforms/

若要永久生效，可将上述两行添加到~/.bashrc或~/.profile文件末尾，执行source ~/.bashrc使配置立即生效。

4. 切换到X11会话（Wayland环境下） #

Ubuntu 22.04默认使用Wayland桌面环境，可能与xcb插件存在兼容性问题。在登录界面点击用户名旁的齿轮图标，选择Ubuntu on Xorg登录后重试。

5. 验证Qt安装完整性 #

打开Qt Maintenance Tool，检查是否安装了Qt 6.5.2下Desktop gcc 64-bit的全部子组件，以及Additional Libraries中的xcb相关组件，若有缺失则补充安装。

完成上述步骤后，重新运行Qt项目即可。

内容的提问来源于stack exchange，提问作者Parisa.H.R.