基于Seleniarm镜像构建Docker容器时Python包安装失败求助

问题背景 #

在树莓派（需支持多架构）上，基于seleniarm/standalone-chromium基础镜像构建Docker镜像、添加Python环境时，无论直接使用pip3 install命令还是通过requirements.txt安装依赖，均构建失败。报错核心为externally-managed-environment，提示系统环境受外部管理，禁止直接用pip安装系统级包。

原Dockerfile内容：

# Use the Selenium base image
FROM seleniarm/standalone-chromium

# Switch to the root user
USER root

# Install Python and pip
RUN apt-get update && \
    apt-get install -y python3 python3-pip

# Set up a working directory
WORKDIR /app

# Copy your Python code or scripts into the container
COPY . /app

# Install required Python packages using pip
RUN pip3 install selenium requests==2.26.0 beautifulsoup4==4.9.3

# Specify the command to run when the container starts
CMD ["python3", "myscript.py"]

脚本依赖的库：

from datetime import datetime, timedelta, time
import time as tm
from selenium.webdriver.common.keys import Keys
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as ec
from selenium.webdriver.common.by import By
from selenium.webdriver import ActionChains

# initiate Chrome driver and open website
from selenium import webdriver
from selenium.webdriver.chrome.service import Service as ChromeService

报错原因 #

基础镜像采用的Debian/Ubuntu系统已启用PEP 668规范，系统级Python环境被标记为外部管理，禁止直接用pip安装包，防止与系统包管理器（apt）的依赖冲突。

解决方案 #

推荐使用Python虚拟环境隔离依赖，这是符合规范的做法，不会破坏系统环境。修改后的Dockerfile如下：

# Use the Selenium base image
FROM seleniarm/standalone-chromium

# Switch to the root user
USER root

# Install Python, pip and venv support
RUN apt-get update && \
    apt-get install -y python3 python3-pip python3-venv && \
    rm -rf /var/lib/apt/lists/*  # 清理apt缓存，减小镜像体积

# Set up a working directory
WORKDIR /app

# Create and activate virtual environment
RUN python3 -m venv /app/venv
ENV PATH="/app/venv/bin:$PATH"

# Copy your Python code and requirements (如果用requirements.txt的话)
COPY . /app

# Install required Python packages using pip in venv
RUN pip install selenium requests==2.26.0 beautifulsoup4==4.9.3
# 如果用requirements.txt，替换成：
# RUN pip install -r requirements.txt

# Specify the command to run when the container starts
CMD ["python", "myscript.py"]

其他可选方案（不推荐） #

如果追求快捷且愿意承担系统环境冲突风险，可以在pip命令后添加--break-system-packages参数，强制绕过PEP668限制：

RUN pip3 install --break-system-packages selenium requests==2.26.0 beautifulsoup4==4.9.3

或者优先使用apt安装系统提供的包版本（注意版本可能与需求不符）：

RUN apt-get install -y python3-selenium python3-requests python3-bs4

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