Ubuntu系统下PyQt5应用无法启动，xcb插件已找到但加载失败

问题根因 #

该报错由OpenCV-Python自带的Qt运行环境与PyQt5依赖的系统Qt环境冲突导致：Qt加载平台插件时优先读取了/usr/local/lib/python3.9/dist-packages/cv2/qt/plugins目录下的不兼容xcb插件，最终加载失败导致应用无法启动。

解决方案 #

可按优先级从高到低尝试以下方案：

方案1：调整代码配置（无需修改依赖，操作最便捷） #

在应用代码的最开头，还未导入任何PyQt5、OpenCV相关模块前，添加环境变量配置，强制Qt使用系统原生的平台插件路径，跳过OpenCV自带的不兼容Qt插件：

import os
os.environ["QT_QPA_PLATFORM_PLUGIN_PATH"] = "/usr/lib/x86_64-linux-gnu/qt5/plugins/platforms"

也可以调整模块导入顺序，先导入所有PyQt5相关模块，最后再导入cv2，同样可以规避冲突。

方案2：替换无Qt依赖的OpenCV版本 #

如果你的应用不需要使用OpenCV自带的GUI功能（如cv2.imshow），直接替换为无Qt依赖的headless版本即可完全根除冲突：

pip uninstall opencv-python -y
pip install opencv-python-headless

方案3：补全xcb运行依赖 #

部分场景下是系统缺失xcb插件的运行依赖导致加载失败，执行以下命令安装全量依赖：

sudo apt update && sudo apt install -y libxcb-xinerama0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-shape0 libxcb-sync1 libxcb-xfixes0 libxcb-xkb1 libxkbcommon-x11-0 libxcb-cursor0

注意事项 #

不要使用sudo权限启动Python GUI应用：sudo会切换到root用户环境，和当前普通用户的Qt配置、图形界面权限不兼容，不仅会触发系统错误报告，还可能修改用户目录下文件的权限，引发更多异常。

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