在没有安装 Qt 的 Linux 上启动 Qt5 应用时出现 “Failed to load platform plugin ‘xcb‘“ 错误的解决方法

在Linux系统上开发和部署Qt5应用时，有时会遇到一个令人头痛的问题——当你在没有安装Qt SDK的系统上运行应用程序时，控制台出现如下错误信息：

Failed to load platform plugin "xcb". Available platforms are:

原因分析

这个问题的根源在于缺少必要的Qt平台插件，尤其是 libqxcb.so，这个插件是用于在X11窗口系统上运行Qt5应用的。

在安装了Qt SDK的系统上，运行Qt应用程序时会自动找到并加载这些插件；但如果系统上没有安装Qt SDK，就需要手动处理这些依赖关系。

解决方法

方法一：安装缺失的库文件

你可以使用 ldd 工具来检查 libqxcb.so 的依赖库，确保所有必要的库文件都在正确的位置并且没有缺失。

ldd path/to/your/libqxcb.so

如果缺少依赖库，会显示出相应的缺失库文件。确保这些库文件在你的系统上安装好。例如，如果缺少 libQt5DBus.so.5，可以尝试安装相应的包：

sudo apt-get install libqt5dbus5

方法二：复制和设置插件路径

1. 复制插件文件和依赖库

   将 libqxcb.so 从开发环境中复制到应用程序的目录下，并创建一个 platforms 目录来存放它：

   mkdir -p path/to/your/app/platforms
   cp path/to/qt/plugins/platforms/libqxcb.so path/to/your/app/platforms/
   

2. 设置环境变量

   设置 QT_QPA_PLATFORM_PLUGIN_PATH 环境变量指向包含平台插件的目录：

   export QT_QPA_PLATFORM_PLUGIN_PATH=path/to/your/app/platforms
   

   然后运行你的应用程序。

方法三：配置 qt.conf

在应用程序目录下创建一个 qt.conf 文件，指定插件目录：

[Paths]
Plugins=path/to/your/app/plugins

调试

如果仍然无法运行，可以启用Qt的调试插件输出，这有助于找出具体问题所在：

export QT_DEBUG_PLUGINS=1

重新运行你的应用程序，检查详细的调试信息，看看有没有提示哪些库文件或路径有问题。

其他可能的解决方案

• 确保系统中安装了所有必要的xcb相关库，例如：

  sudo apt-get install libx11-xcb1 libxcb1 libxkbcommon-x11-0
  

• 检查是否有文件权限问题，确保所有库文件和插件具有正确的读取权限：

  sudo chmod 775 path/to/your/libraries/*