SSH远程运行COLMAP时Qt平台插件初始化失败求助

针对SSH连接Ubuntu 20.04.6时，Conda环境内Python调用COLMAP触发的Qt平台插件问题，以下是经过验证的解决方案：

1. 正确配置Qt插件路径与环境变量 #

首先定位Conda环境中Qt的platforms目录，通常位于：
$CONDA_PREFIX/lib/qt5/plugins/platforms
或（若使用PyQt）：
$CONDA_PREFIX/lib/pythonX.X/site-packages/PyQt5/Qt5/plugins/platforms

设置环境变量指向该路径并指定offscreen平台：

export QT_PLUGIN_PATH=$CONDA_PREFIX/lib/qt5/plugins
export QT_QPA_PLATFORM=offscreen
unset DISPLAY  # 清除可能干扰的DISPLAY变量

执行后重新运行Python脚本。

2. 修复Conda环境的Qt依赖冲突 #

卸载现有Qt及COLMAP，重新安装兼容版本：

conda remove --force colmap pyqt qt
conda install -c conda-forge colmap pyqt=5.15

安装完成后重复步骤1的环境变量配置。

3. 临时切换到系统Qt（应急方案） #

若Conda环境的Qt存在顽固冲突，可临时让系统Qt优先加载：

export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH
export QT_QPA_PLATFORM=offscreen
unset DISPLAY

注意：此方法可能影响环境内其他Qt依赖包，仅作为临时测试。

4. 源码编译COLMAP时开启Offscreen支持 #

如果是自行编译COLMAP，确保编译阶段指定Qt offscreen支持：

cmake -DCMAKE_BUILD_TYPE=Release -DQMAKE_EXECUTABLE=/usr/bin/qmake ..
make -j$(nproc)

编译完成后调用本地编译的COLMAP二进制文件，而非Conda安装版本。

问题背景 #

通过SSH连接Ubuntu 20.04.6 LTS服务器，在Conda虚拟环境中运行Python脚本调用COLMAP处理数据集时，程序崩溃并提示Qt平台插件"offscreen"找不到。尝试设置export QT_QPA_PLATFORM=offscreen、安装libxcb-xinerama0/libxcb-cursor0、复制platforms目录至bin目录等操作均无效；开启DEBUG模式后，错误变为"xcb插件找到但无法连接显示"，程序依旧崩溃。

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