Ubuntu 21.10升级后Qt平台插件xcb加载失败该如何修复？

故障根源 #

从调试日志可知，故障是Anaconda环境内的Qt5库版本与Ubuntu 21.10系统环境不兼容，libQt5XcbQpa.so.5库缺少对应符号，同时Ubuntu 21.10默认启用的Wayland显示服务器也可能引发Qt平台插件加载异常。

可行解决方案（按优先级排序） #

方案1：修复Anaconda环境Qt依赖冲突

• 先激活Anaconda基础环境：conda activate base
• 强制重装PyQt和Qt核心包，覆盖损坏的库文件：conda install --force-reinstall pyqt qt
• 重装完成后测试启动Anaconda Navigator：anaconda-navigator

方案2：指定Qt使用Wayland平台适配系统默认显示服务

• 单次启动测试直接执行：QT_QPA_PLATFORM=wayland anaconda-navigator
• 如需永久生效，将export QT_QPA_PLATFORM=wayland写入用户目录下的.bashrc（或.zshrc，对应你使用的shell）文件，重启终端后即可全局生效。

方案3：降级Anaconda内Qt到兼容版本

• 先查看当前Qt版本：conda list qt
• 安装适配性更好的5.12.x系列版本：conda install qt=5.12
• 安装完成后重新测试Python Qt程序启动。

方案4：补装系统层面xcb依赖库

如果是系统缺少xcb相关依赖导致插件加载失败，执行命令安装对应包：
sudo apt install libxcb-xinerama0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-xkb1 libxkbcommon-x11-0

故障排查步骤 #

如果上述方案均未生效，可按以下步骤定位问题：

• 执行which python确认输出路径为Anaconda目录下的Python，避免调用了系统Python引发环境冲突。
• 新建干净的测试环境验证Qt功能是否正常：

conda create -n test_qt python=3.8 pyqt -y
conda activate test_qt
python -c "from PyQt5.QtWidgets import QApplication; app = QApplication([]); print('Qt运行正常')"

如果测试环境运行正常，说明原全局环境配置混乱，可迁移原环境内的第三方包到新环境使用。

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