M1芯片MacOS构建Docker镜像安装PyQt5报错求助

问题场景 #

在M1芯片的Mac（macOS Monterey 12.6系统）上构建基于Ubuntu的Docker镜像时，执行pip3 install PyQt5步骤出现以下错误：

AttributeError: module 'sipbuild.api' has no attribute 'prepare_metadata_for_build_wheel'

对应的Dockerfile内容如下：

FROM ubuntu:latest

# Preparing work environment
ADD server.py .
RUN apt-get update
RUN apt-get upgrade
RUN apt-get -y install python3
RUN apt-get -y install python3-pip
# Preparing work environment

RUN pip3 install PyQt5 # The error occurred in this line

问题原因 #

核心原因是Ubuntu镜像自带的python3-pip版本过低，老旧版本的pip无法支持PyQt5最新版本构建时依赖的sipbuild API，从而触发属性不存在的报错。另外M1芯片的arm64架构在构建x86_64 Ubuntu镜像时，会放大老旧工具的兼容性问题。

解决办法 #

方法一：升级pip后再安装PyQt5 #

修改Dockerfile，在安装PyQt5前先将pip升级到最新版本：

FROM ubuntu:latest

# Preparing work environment
ADD server.py .
RUN apt-get update && apt-get upgrade -y
RUN apt-get -y install python3 python3-pip
# Preparing work environment

RUN pip3 install --upgrade pip  # 先升级pip
RUN pip3 install PyQt5

方法二：直接安装Ubuntu源中的PyQt5包 #

如果不需要PyQt5的最新版本，可直接通过apt安装系统预编译的PyQt5包，跳过pip编译环节，稳定性更高：

FROM ubuntu:latest

# Preparing work environment
ADD server.py .
RUN apt-get update && apt-get upgrade -y
RUN apt-get -y install python3 python3-pyqt5  # 直接安装系统提供的PyQt5
# Preparing work environment

额外优化建议 #

• 合并apt-get相关命令，减少镜像构建层数，提升构建效率（比如将update、upgrade、install合并为一条RUN指令）
• 若需要指定PyQt5版本，可在pip install后添加版本号，例如pip3 install PyQt5==5.15.9，适配低版本pip的兼容性

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