Docker容器化PyQt5应用遇ModuleNotFoundError问题求助

问题场景 #

要容器化一个简单的PyQt5应用，app.py代码如下：

# app.py

import sys

# 1. Import QApplication and all the required widgets
from PyQt5.QtWidgets import QApplication, QLabel, QWidget

# 2. Create an instance of QApplication
app = QApplication([])

# 3. Create your application's GUI
window = QWidget()
window.setWindowTitle("PyQt App")
window.setGeometry(100, 100, 280, 80)
helloMsg = QLabel("<h1>Hello, World!</h1>", parent=window)
helloMsg.move(60, 15)

# 4. Show your application's GUI
window.show()

# 5. Run your application's event loop
sys.exit(app.exec())

最初使用的Dockerfile：

# Use an official Python runtime as a base image
FROM python:3.8

# Set the working directory in the container
WORKDIR /app

# Update package repository and install dependencies
RUN apt-get update && \
    apt-get install -y python3-pyqt5 && \
    rm -rf /var/lib/apt/lists/*

# Copy the current directory contents into the container at /app
COPY . /app

# Run the PyQt5 app when the container launches
CMD ["python", "app.py"]

执行构建和运行命令后出现两种错误：

1. 使用apt-get安装python3-pyqt5时，启动容器报错：

Traceback (most recent call last):
  File "app.py", line 6, in <module>
    from PyQt5.QtWidgets import QApplication, QLabel, QWidget
ModuleNotFoundError: No module named 'PyQt5'

2. 改用RUN pip install --no-cache-dir PyQt5时，启动容器报错：

Traceback (most recent call last):
  File "app.py", line 6, in <module>
    from PyQt5.QtWidgets import QApplication, QLabel, QWidget
ImportError: libGL.so.1: cannot open shared object file: No such file or directory

错误原因 #

• 第一种错误：官方python:3.8镜像中的Python位于/usr/local/bin/python，而apt-get安装的python3-pyqt5是为系统自带的Python（/usr/bin/python3）准备的，两个Python环境相互独立，因此容器中运行的python找不到PyQt5模块。
• 第二种错误：PyQt5依赖OpenGL相关系统库，官方Python镜像默认未安装这些库，导致加载PyQt5时缺失libGL.so.1。

解决方案 #

方案一：使用系统Python环境配合apt安装PyQt5 #

改用Debian基础镜像，直接安装系统Python和对应的PyQt5包，确保环境匹配：

FROM debian:buster-slim

WORKDIR /app

# 安装系统Python和PyQt5
RUN apt-get update && \
    apt-get install -y --no-install-recommends python3 python3-pyqt5 && \
    rm -rf /var/lib/apt/lists/*

COPY . /app

# 使用系统python3运行应用
CMD ["python3", "app.py"]

方案二：用pip安装PyQt5并补充系统依赖 #

在官方Python镜像中先安装PyQt5所需的系统库，再通过pip安装PyQt5：

FROM python:3.8

WORKDIR /app

# 安装PyQt5依赖的系统库：解决libGL.so.1缺失问题
RUN apt-get update && \
    apt-get install -y --no-install-recommends libgl1-mesa-glx libglib2.0-0 && \
    rm -rf /var/lib/apt/lists/*

# 通过pip安装PyQt5
RUN pip install --no-cache-dir PyQt5

COPY . /app

CMD ["python", "app.py"]

额外注意事项 #

容器中的GUI应用需要连接主机的X11显示服务，运行容器时需添加以下参数：

docker run --rm -it -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix myapp

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