docker

关注公众号 jb51net

关闭
首页 > 网站技巧 > 服务器 > 云和虚拟化 > docker > docker启动labelImg报错

解决在 Docker 中启动 labelImg 的相关报错

作者：饭来_

文章介绍了在Ubuntu-22.04中使用Miniconda3创建的Python 3.10虚拟环境下安装labelImg时遇到的两个主要错误及其解决方法：libGL报错和xcb插件报错,解决方法包括安装libGL库和补齐Qt5的xcb依赖项,感兴趣的朋友跟随小编一起看看吧

一、简介

本文提到的报错信息，是在 ubuntu-22.04 中通过 miniconda3 创建的 python-3.10 版本的虚拟环境下安装的labelImg提示的报错。参考如下版本信息，如果有相关的报错可以参考本文的解决方法执行。部分问题也可以通过 减低版本 来解决，需要具体情况具体分析。这里不保证完全有效，仅供参考。

# Name                    Version                   Build  Channel
_libgcc_mutex             0.1                        main  
_openmp_mutex             5.1                       1_gnu  
bzip2                     1.0.8                h5eee18b_6  
ca-certificates           2025.12.2            h06a4308_0  
expat                     2.7.3                h7354ed3_4  
labelimg                  1.8.6                    pypi_0    pypi
ld_impl_linux-64          2.44                 h153f514_2  
libexpat                  2.7.3                h7354ed3_4  
libffi                    3.4.4                h6a678d5_1  
libgcc                    15.2.0               h69a1729_7  
libgcc-ng                 15.2.0               h166f726_7  
libgomp                   15.2.0               h4751f2c_7  
libnsl                    2.0.0                h5eee18b_0  
libstdcxx                 15.2.0               h39759b7_7  
libstdcxx-ng              15.2.0               hc03a8fd_7  
libuuid                   1.41.5               h5eee18b_0  
libxcb                    1.17.0               h9b100fa_0  
libzlib                   1.3.1                hb25bd0a_0  
lxml                      6.0.2                    pypi_0    pypi
ncurses                   6.5                  h7934f7d_0  
openssl                   3.0.18               hd6dcaed_0  
pip                       25.3               pyhc872135_0  
pthread-stubs             0.3                  h0ce48e5_1  
pyqt5                     5.15.11                  pypi_0    pypi
pyqt5-qt5                 5.15.18                  pypi_0    pypi
pyqt5-sip                 12.17.2                  pypi_0    pypi
python                    3.10.19              h6fa692b_0  
readline                  8.3                  hc2a1206_0  
setuptools                80.9.0          py310h06a4308_0  
sqlite                    3.51.0               h2a70700_0  
tk                        8.6.15               h54e0aa7_0  
tzdata                    2025b                h04d1e81_0  
wheel                     0.45.1          py310h06a4308_0  
xorg-libx11               1.8.12               h9b100fa_1  
xorg-libxau               1.0.12               h9b100fa_0  
xorg-libxdmcp             1.1.5                h9b100fa_0  
xorg-xorgproto            2024.1               h5eee18b_1  
xz                        5.6.4                h5eee18b_1  
zlib                      1.3.1                hb25bd0a_0

二、libGL 报错&解决方法

容器是精简版的 Linux，默认没有 libGL 图形驱动库，所以会提示找不到文件。

Traceback (most recent call last):
  File "/opt/miniconda3/envs/labelImg/lib/python3.10/site-packages/labelImg/labelImg.py", line 18, in <module>
    from PyQt5.QtGui import *
ImportError: libGL.so.1: cannot open shared object file: No such file or directory
During handling of the above exception, another exception occurred:
Traceback (most recent call last):
  File "/opt/miniconda3/envs/labelImg/bin/labelImg", line 3, in <module>
    from labelImg.labelImg import main
  File "/opt/miniconda3/envs/labelImg/lib/python3.10/site-packages/labelImg/labelImg.py", line 27, in <module>
    import sip
ModuleNotFoundError: No module named 'sip'
  1. 执行如下指令解决上述 libGL 报错。 
    apt update && apt install -y libgl1-mesa-glx libglib2.0-0 libx11-xcb1
  2. 执行如下指令解决上述 python 依赖，其实在安装 labelimg 的时候已经安装过了。
    # 1. 先安装 pyqt5 相关的 sip
pip install PyQt5-sip
# 2. 重新安装 pyqt5 (确保版本完整)
pip install PyQt5
# 3. 如果依然报错，尝试安装特定版本的 lxml
pip install lxml
  3. 需要注意，容器内指定的显示器编号需要和宿主机一致，并且需要具有权限可视化，应最先确认如下信息。
    echo $DISPLAY  # 获取宿主机显示器编号
echo "export DISPLAY=:1" >> ~/.bashrc  # 在容器内指定相同编号，以 1 为例

三、xcb 插件报错&解决方法

报错 xcb 插件加载失败，是因为 PyQt5 运行所需的底层 XCB 相关库在容器内还不完整。

qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" 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: eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, wayland-egl, wayland, wayland-xcomposite-egl, wayland-xcomposite-glx, webgl, xcb.
Aborted (core dumped)

执行如下指令，补齐 Qt5 缺失的所有 xcb 依赖。

apt update && apt install -y \
    libxcb-xinerama0 \
    libxcb-icccm4 \
    libxcb-image0 \
    libxcb-keysyms1 \
    libxcb-render-util0 \
    libxcb-xfixes0 \
    libxcb-shape0 \
    libxcb-randr0 \
    libxkbcommon-x11-0 \
    libdbus-1-3

小结

以上内容作为错误记录，仅供参考，不保证完全有效，后续会不断增加。如有其他问题欢迎在评论区讨论！！

到此这篇关于解决在 Docker 中启动 labelImg 的相关报错的文章就介绍到这了,更多相关docker启动labelImg报错内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:
阅读全文