树莓派（PiOS）编译Qt 6.9.0后xcb平台插件加载失败求助

以下是针对该问题的分步解决方案：

• 补全xcb相关依赖
  PiOS默认可能缺少Qt编译xcb插件所需的完整依赖，先执行以下命令安装：

sudo apt update && sudo apt install libxcb-xinerama0 libxcb-xinput0 libxcb-randr0-dev libxcb-util-dev libxcb-cursor-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev libxcb-shape0-dev libxcb-icccm4-dev libxcb-image0-dev libxcb-keysyms1-dev libxcb-render-util0-dev libxcb-sync-dev libxcb-xfixes0-dev

• 重新配置并编译Qt
  之前的configure命令可能未充分启用xcb相关模块，删除原编译目录的临时文件后，重新执行配置：

./configure -qpa xcb -prefix /home/user/dev/compile_qt/install_release -release -opensource -xcb -xcb-xlib -xcb-xinput -xcb-cursor -xcb-randr -xcb-shape -xcb-xfixes -xcb-sync -xcb-icccm -xcb-image -xcb-keysyms -xcb-render-util

然后并行编译（利用树莓派全部核心加快速度）并安装：

cmake --build . --parallel $(nproc)
cmake --install .

• 指定Qt插件运行路径
  如果编译完成后仍报错，可能是Qt运行时找不到platforms插件目录，临时设置环境变量测试：

export QT_QPA_PLATFORM_PLUGIN_PATH=/home/user/dev/compile_qt/install_release/plugins/platforms

若生效，可将该命令添加到~/.bashrc文件末尾实现永久生效。

• 验证插件文件与依赖

1. 检查安装目录下是否存在xcb插件：

ls /home/user/dev/compile_qt/install_release/plugins/platforms/libqxcb.so

若文件不存在，说明编译未生成该插件，回到第一步补全依赖后重新编译。
2. 检查插件的依赖库是否完整：

ldd /home/user/dev/compile_qt/install_release/plugins/platforms/libqxcb.so

输出中若出现not found的库，对应安装即可解决。

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