Qt 6.5.2 Ubuntu 22.04启动报错：xcb插件加载失败求解决

问题重现 #

在MacOS上开发的Qt 6.5.2应用编译运行正常，但在Ubuntu 22.04编译完成后启动时抛出以下错误：

qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Available platform plugins are: offscreen, linuxfb, vnc, wayland-egl, eglfs, xcb, minimalegl, wayland, vkkhrdisplay, minimal.

已设置QT_PLUGIN_PATH=/opt/Qt/6.5.2/gcc_64/plugins，且插件目录结构完整，但问题未解决。

错误原因 #

错误提示明确"xcb插件已找到但无法加载"，核心原因是xcb插件依赖的Ubuntu系统底层库缺失。Qt的xcb平台插件依赖X11相关的系统组件，这些组件并非Ubuntu 22.04默认完整安装的包。通过QT_DEBUG_PLUGINS=1输出的日志可以看到，插件加载时无法找到部分依赖库（例如libxcb-cursor.so.0、libxcb-icccm.so.4等）。

解决步骤 #

1. 安装xcb相关系统依赖包 #

执行以下命令安装Qt 6.5.2运行xcb插件所需的全部依赖：

sudo apt update && sudo apt install libxcb-cursor0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-shape0 libxcb-xinerama0 libxcb-xkb-dev xkb-data

2. 验证插件依赖完整性 #

使用ldd命令检查xcb插件的依赖是否全部存在：

ldd /opt/Qt/6.5.2/gcc_64/plugins/platforms/libqxcb.so

查看输出中的not found项，若仍有缺失，根据缺失的库名通过apt search查找对应的包并安装。

3. 配置正确的环境变量 #

除了QT_PLUGIN_PATH，还需确保Qt的核心库路径被系统识别，将以下命令添加到终端配置文件（如~/.bashrc）或应用启动脚本中：

export LD_LIBRARY_PATH=/opt/Qt/6.5.2/gcc_64/lib:$LD_LIBRARY_PATH
export QT_PLUGIN_PATH=/opt/Qt/6.5.2/gcc_64/plugins

执行source ~/.bashrc使配置立即生效。

4. 测试应用启动 #

重新启动应用，若仍有问题，再次开启调试日志QT_DEBUG_PLUGINS=1 ./your_app，确认所有依赖已加载成功。

补充说明 #

MacOS与Ubuntu的Qt运行环境依赖完全不同：MacOS使用Apple原生框架，而Linux依赖X11/xcb系统库，因此跨平台部署时需单独处理Linux端的系统依赖。

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