RK3568平台PyInstaller打包应用持续报错：找不到Qt xcb插件

1. 补全嵌入式设备的系统依赖 #

嵌入式系统多为最小化安装，大概率缺失xcb插件依赖的底层系统库。按以下步骤排查修复：

• 启动应用后，在嵌入式设备上找到临时解压目录（如/tmp/_MEIxxxxx），执行命令查看libqxcb.so的缺失依赖：

  ldd /tmp/_MEIxxxxx/cv2/qt/plugins/platforms/libqxcb.so
  

• 根据输出的缺失项安装对应系统包，以Debian/Ubuntu系为例：

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

2. 修正PyInstaller的资源路径映射 #

你的--add-data参数将platforms插件放到了根目录的./platforms，但OpenCV默认期望插件在cv2/qt/plugins/platforms路径下。修改打包命令：

pyinstaller --clean --onefile --hidden-import="PIL._tkinter_finder" \
--add-data "/home/user/venv/lib/python3.6/site-packages/cv2/qt/plugins/platforms:cv2/qt/plugins/platforms" \
my_app.py

3. 动态设置Qt插件路径（脚本内） #

单文件模式下，PyInstaller会把资源解压到临时目录sys._MEIPASS，在Python脚本开头添加以下代码，动态指定插件路径：

import os
import sys

if hasattr(sys, '_MEIPASS'):
    # 指向解压后的cv2 Qt插件目录
    qt_plugins_dir = os.path.join(sys._MEIPASS, 'cv2', 'qt', 'plugins', 'platforms')
    os.environ['QT_QPA_PLATFORM_PLUGIN_PATH'] = qt_plugins_dir
# 强制指定使用xcb平台
os.environ['QT_QPA_PLATFORM'] = 'xcb'

4. 对齐编译与目标设备的系统环境 #

Docker镜像的系统版本、库版本和嵌入式设备可能存在差异（比如Ubuntu镜像 vs Yocto/Debian轻量版系统），导致打包的库无法兼容：

• 使用和嵌入式设备完全一致的系统镜像构建Docker编译环境
• 确保编译环境中安装的Qt、xcb库版本与目标设备完全匹配

5. （可选）禁用OpenCV的Qt依赖（无需GUI时） #

如果你的应用不需要OpenCV的GUI功能，可以直接在打包时排除Qt相关模块，彻底避免插件加载问题：

pyinstaller --clean --onefile --hidden-import="PIL._tkinter_finder" \
--exclude-module=cv2.qt \
my_app.py

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