Ubuntu 22.04中解决Could not load the Qt platform plugin “xcb“问题解决方法

摘要：在Ubuntu 22.04中安装OpenCV后，遇到“load the Qt platform plugin “xcb” in site-packages/cv2/qt/plugins" even though it was found. 的问题，导致程序无法启动。本文详细探讨了该问题的成因，并介绍了几种常见但无效的解决方法，包括设置环境变量、重装OpenCV或PySide6、以及降低OpenCV或Qt版本等。这些方法未能处理系统中缺失的XCB相关依赖项。最终，本文通过命令sudo apt install libxcb-*来安装所有与XCB相关的库，从而成功解决问题。

1. 引言

在Linux环境下，尤其是使用Ubuntu时，我们经常会选择OpenCV来进行图像处理和计算机视觉开发。最近，我在Ubuntu 22.04中安装OpenCV并运行代码时，遇到了一个比较棘手的问题——“Could not load the Qt platform plugin ‘xcb’”。这个问题直接导致程序无法启动，尽管系统已经找到了相应的插件。经过多次尝试和研究，我终于找到了一个有效的解决方案。在这篇博客中，我细介绍这个问题的解决过程，希望能帮助到同样遇到此问题的开发人员。

2. 错误描述

首先说一下，我的项目中使用了PyTorch、OpenCV和PySide6这些库，其实就是使用QT界面显示深度学习的一些项目。在Windows中运行良好，但同样的代码，在安装完OpenCV并尝试在ubuntu上运行时，终端报出了以下错误：

load the Qt platform plugin "xcb" in "/home/mindcraft/miniconda3/envs/env_rec/lib/python3.10/site-packages/cv2/qt/plugins" 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: vkkhrdisplay, xcb, minimal, wayland, minimalegl, wayland-egl, linuxfb, vnc, offscreen, eglfs.

从错误信息来看，问题的核心在于Qt无法加载xcb平台插件，即使系统已经找到了这个插件。这个问题比较奇怪，因为这个错误很容易以为是PyQt5或者PySide6的库报出来的。一般QT的环境变量没有设置好，也会提示说不能载入插件。

在这里插入图片描述

但仔细看这个错误是OpenCV报出来的，提示信息里面的“cv2/qt/plugins”就是OpenCV。我又想到会不会是PySide6的QT环境变量与OpenCV的相互影响了？找了一通，被很多教程给误导，没能解决。

3. 常见但无效的解决方法

在尝试解决这个问题的过程中，找到了很多以下常见但无效的解决方法：

设置环境变量：
很多教程建议设置环境变量export QT_QPA_PLATFORM=xcb，以确保Qt使用正确的插件，或者设置成vkkhrdisplay, xcb, minimal, wayland, minimalegl, wayland-egl, linuxfb, vnc, offscreen, eglfs这些其中的任一个。然而，尽管设置了这个变量，问题依然存在，并没有实质性的改善。这是因为该设置只是指示Qt使用特定的平台插件，而并未解决插件初始化失败的根本问题。
安装基础库：
常见的做法是安装一些与XCB相关的基础库，如：
```
sudo apt-get install libxcb1 libxcb-util1 libx11-xcb1 libxrender1 libxrandr2 libxi6
```
虽然这些库的安装可能会解决某些依赖性问题，但由于没有涵盖所有XCB相关的依赖项，因此大多数情况下问题依然存在。
重装OpenCV或重装PySide6：
尝试通过重新安装OpenCV或重装PySide6来解决问题，命令如下：
```
pip uninstall opencv-python
pip install PySide6
pip install opencv-python
pip install PySide6
```
虽然重新安装OpenCV可以确保所有OpenCV组件被正确配置，但由于问题的根源在于Qt和XCB的依赖性，而非OpenCV本身，所以这种方法通常不会解决问题。
降低OpenCV或Qt版本：
一些开发者可能会尝试通过降低OpenCV或Qt的版本来解决兼容性问题。然而，这种方法也没有奏效，更换版本有时甚至会引入其他问题，导致新的兼容性问题。