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

更新时间：2026年01月05日 09:46:24 作者：饭来_

文章介绍了在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'

执行如下指令解决上述 libGL 报错。

apt update && apt install -y libgl1-mesa-glx libglib2.0-0 libx11-xcb1

执行如下指令解决上述 python 依赖，其实在安装 labelimg 的时候已经安装过了。

# 1. 先安装 pyqt5 相关的 sip
pip install PyQt5-sip
# 2. 重新安装 pyqt5 (确保版本完整)
pip install PyQt5
# 3. 如果依然报错，尝试安装特定版本的 lxml
pip install lxml

需要注意，容器内指定的显示器编号需要和宿主机一致，并且需要具有权限可视化，应最先确认如下信息。
```
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报错内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

一步步详解如何在Ubuntu 18.04上安装Docker
Docker是基于Go语言实现的云开源项目,下面这篇文章主要给大家介绍了关于如何在Ubuntu 18.04上安装Docker的相关资料,文中通过图文介绍的非常详细,需要的朋友可以参考下
2023-06-06
docker search 搜索镜像的实现示例
本文主要介绍了docker search搜索镜像的实现示例,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧
2024-02-02
使用Docker搭建MQTT服务器的过程详解
这篇文章主要介绍了使用Docker搭建MQTT服务器的过程，本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
2021-12-12
docker 运行花生壳实现内外网穿透的详细过程
这篇文章主要介绍了docker 运行花生壳实现内外网穿透,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2023-03-03
docker 如何修改容器的端口
正在运行的容器端口冲突了,但是还需要这个容器,怎么办？只能修改端口了,今天通过本文给大家介绍docker 如何修改容器的端口,感兴趣的朋友一起看看吧
2024-01-01
docker daemon远程连接设置详解
本篇文章主要介绍了docker daemon远程连接设置详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-04-04
Docker配置WebSSH的实现
本文主要介绍了Docker配置WebSSH的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-03-03
Docker创建镜像两种方法详解
这篇文章主要介绍了 Docker创建镜像两种方法详解的相关资料,Docker创建镜像：一是使用docker commit命令，二是使用docker build命令和Dockerfile文件，需要的朋友可以参考下
2016-12-12
Docker pull镜像拉取失败完整解决过程
这篇文章主要介绍了Docker pull镜像拉取失败解决的相关资料,包括编辑daemon.json文件、重启Docker服务、查询替换结果以及处理可能的重启问题,文中通过代码介绍的非常详细需要的朋友可以参考下
2025-04-04
Docker 配置固定IP及桥接的实现方法
这篇文章主要介绍了Docker 配置固定IP和桥接的实现方法的相关资料,这里详细介绍了Docker 的四种网络模式及如何实现桥接的案例，需要的朋友可以参考下
2016-10-10