python:3.12-alpine中apk安装的py3-pandas等包无法访问问题

问题根源 #

Alpine Linux 的py3-*系列包是基于系统默认 Python 版本构建的，但python:3.12-alpine镜像里，官方把 Python 3.12 安装在/usr/local/bin目录下，而系统自带的默认 Python 还是 3.11。所以用apk add安装的py3-pandas、py3-scipy会被放到/usr/lib/python3.11/site-packages，和 Python 3.12 的/usr/local/lib/python3.12/site-packages路径完全不重合，自然无法被识别。

解决方案 #

方案1：用pip替代apk安装（推荐）

直接把 pandas、scipy 放到requirements.in里通过 pip 安装，这样能保证包和 Python 3.12 版本兼容，还能灵活控制版本。修改后的 Dockerfile 如下：

FROM python:3.12-alpine

ENV PYTHONUNBUFFERED=1

# 仅保留编译依赖，移除apk的py3-pandas、py3-scipy
RUN apk add --no-cache \
                gcc g++ libffi-dev musl-dev \
 && pip3 install pip-tools

WORKDIR /app
COPY requirements.in  .
# 在requirements.in中添加pandas、scipy（可指定版本）
RUN pip-compile requirements.in > requirements.txt \
 && pip3 install -r requirements.txt

ENTRYPOINT ["sh"]

方案2：修改PYTHONPATH兼容（不推荐）

如果非要用 apk 安装，需要把 Python 3.11 的 site-packages 路径加入到 PYTHONPATH 中，让 3.12 能找到这些包。但这种方式存在版本兼容风险（3.11 的包可能在 3.12 下运行异常），谨慎使用：

FROM python:3.12-alpine

ENV PYTHONUNBUFFERED=1
# 同时添加两个版本的site-packages路径
ENV PYTHONPATH="/usr/local/lib/python3.12/site-packages:/usr/lib/python3.11/site-packages"

RUN apk add --no-cache \
                gcc g++ libffi-dev musl-dev \
                py3-pandas py3-scipy \
 && pip3 install pip-tools

WORKDIR /app
COPY requirements.in  .
RUN pip-compile requirements.in > requirements.txt \
 && pip3 install -r requirements.txt

ENTRYPOINT ["sh"]

注意事项 #

• apk 的py3-*包版本通常比较滞后，用 pip 安装能获取到更新的版本。
• 跨 Python 版本使用 site-packages 容易出现导入错误、运行时崩溃等问题，优先推荐方案1。

内容的提问来源于stack exchange，提问作者Pratik K.