Docker镜像中安装Playwright==1.27.1失败，寻求解决方案

你遇到的安装失败问题，根源在于使用了python:3.9-alpine镜像：Playwright 1.27.1没有适配Alpine Linux的预编译wheel包，且Alpine采用的musl libc与大多数Python包依赖的glibc不兼容，导致pip无法找到匹配的发行版。

方案1：切换到Debian-based Python镜像（推荐） #

改用python:3.9-slim（轻量化Debian镜像），Playwright有针对glibc环境的预编译包，安装更顺畅，且兼容性更好。

修改后的Dockerfile：

FROM python:3.9-slim

# 安装Playwright浏览器运行所需的系统依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 \
    libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libasound2 \
    && rm -rf /var/lib/apt/lists/*

COPY ../../requirements/dev.txt ./

RUN python3 -m ensurepip
RUN pip install --no-cache-dir -r dev.txt

# 安装Playwright浏览器驱动（本地环境已预装，但Docker镜像需要手动安装）
RUN playwright install --with-deps

ENV PYTHONPATH "${PYTHONPATH}:/app/"
WORKDIR /code/src

COPY ./src /app

CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]

方案2：坚持使用Alpine镜像（不推荐，复杂度高） #

若必须用Alpine，需安装编译依赖并调整Playwright运行环境，但旧版本（1.27.1）对musl libc支持有限，可能出现编译失败：

FROM python:3.9-alpine

# 安装编译依赖和系统级浏览器
RUN apk add --no-cache \
    gcc g++ make libc-dev \
    chromium chromium-chromedriver \
    nss freetype harfbuzz ca-certificates

COPY ../../requirements/dev.txt ./

RUN python3 -m ensurepip
# 强制源码编译（可能因依赖问题失败）
RUN pip install --no-cache-dir --no-binary :all: -r dev.txt

# 指定Playwright使用系统安装的Chromium
ENV PLAYWRIGHT_BROWSERS_PATH=/usr/bin/chromium

ENV PYTHONPATH "${PYTHONPATH}:/app/"
WORKDIR /code/src

COPY ./src /app

CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]

优先选择方案1，Debian-based镜像能避免musl libc带来的兼容性问题，且Playwright的预编译包安装速度更快、稳定性更高。

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