Alpine镜像部署含Scikit-learn的Python项目遇Poetry安装失败求助

问题根源 #

Alpine使用musl libc，而scikit-learn官方提供的预编译轮子是基于glibc构建的（比如Debian slim镜像采用的就是glibc），因此在Alpine环境下只能从源码编译安装scikit-learn。如果缺少必要的系统编译依赖，就会出现解压或编译失败的PoetryException。

具体解决步骤 #

1. 补充Alpine系统编译依赖 #

在Dockerfile中，基于python:3.9-alpine镜像构建时，先安装编译scikit-learn及其依赖所需的系统工具和库：

RUN apk add --no-cache \
    gcc \
    g++ \
    make \
    cmake \
    openblas-dev \
    lapack-dev \
    python3-dev \
    py3-pip

各依赖的作用：

• gcc/g++/make/cmake：提供C/C++编译工具链，用于编译底层扩展
• openblas-dev/lapack-dev：scikit-learn依赖的线性代数运算库
• python3-dev：Python开发头文件，用于编译Python扩展模块

2. 调整Poetry配置 #

Docker容器本身已是隔离环境，可禁用Poetry的虚拟环境，避免额外的环境层：

# 安装Poetry
RUN pip install poetry
# 禁用虚拟环境
RUN poetry config virtualenvs.create false

3. 完整Dockerfile示例 #

FROM python:3.9-alpine

WORKDIR /app

# 安装编译依赖
RUN apk add --no-cache \
    gcc \
    g++ \
    make \
    cmake \
    openblas-dev \
    lapack-dev \
    python3-dev \
    py3-pip

# 配置Poetry
RUN pip install poetry
RUN poetry config virtualenvs.create false

# 复制项目配置文件
COPY pyproject.toml poetry.lock* ./

# 安装项目依赖
RUN poetry install --no-root --no-interaction --no-ansi

# 复制项目代码
COPY helloworld.py ./

# 运行程序
CMD ["python", "helloworld.py"]

4. 可选：缩减镜像体积 #

编译完成后，可删除编译工具链，减小最终镜像大小：

RUN apk del gcc g++ make cmake python3-dev

验证说明 #

修改后，Poetry会在Alpine环境中从源码编译scikit-learn及其依赖，完成安装后即可正常运行helloworld.py脚本。

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