symbol version Qt_5_PRIVATE_API not defined in libQt5Gui.so.5 解决方法

Qt_5_PRIVATE_API not defined 通常提示插件或扩展加载了不匹配的 Qt 动态库。需要确认“哪个插件”与“哪套 Qt”发生冲突，而不是只根据 PyQt5-sip 版本猜测一个旧版 PyQt5。

1. 记录解释器与 Qt 版本

python -m pip show PyQt5 PyQt5-Qt5 PyQt5-sip
python -m pip check
python -c "from PyQt5.QtCore import QT_VERSION_STR, PYQT_VERSION_STR; print(QT_VERSION_STR, PYQT_VERSION_STR)"

QT_VERSION_STR 表示绑定编译时的 Qt 版本。进一步查看实际运行的版本与插件目录：

from PyQt5.QtCore import QLibraryInfo, qVersion

print("Runtime Qt:", qVersion())
print("Plugins:", QLibraryInfo.location(QLibraryInfo.PluginsPath))

2. 查看插件与动态库来源

QT_DEBUG_PLUGINS=1 python app.py
LD_DEBUG=libs python app.py
printenv QT_PLUGIN_PATH QT_QPA_PLATFORM_PLUGIN_PATH LD_LIBRARY_PATH

如果系统 Qt、pip 自带 Qt、Conda Qt 或 OpenCV 的插件目录混在一起，优先在独立环境复现并统一来源。Qt 对插件版本有兼容性检查，私有 API 更不能按公共 API 的兼容假设处理。Qt 插件部署文档

3. 用最小窗口验收

先运行只导入 PyQt5 并创建 QApplication 的小程序，再逐个加回 OpenCV、Matplotlib 等依赖。若只有某个依赖加入后失败，比较加入前后的插件搜索路径。

确需重装时，让包管理器为当前 Python 版本解析一组相容依赖，并保存版本清单。不要把 PyQt5==5.13.2 视为所有平台、Python 和系统 Qt 的通用修复版本。

阅读自测与验收

• 记录导入的 Qt binding、Qt 版本和插件目录，检查应用是否同时加载了不兼容的 Qt5/Qt6 组件。
• 用同一环境启动最小窗口，再逐步加回 Matplotlib、OpenCV 等依赖；不要在最小窗口尚未成功时调试业务界面。