如何解决Docker构建Streamlit镜像时pyarrow Wheel编译失败问题？

问题根源 #

在Debian 12 + Python 3.12环境中，pip尝试从源码编译pyarrow，但系统缺少Arrow库的开发依赖，导致CMake无法找到Arrow的配置文件（ArrowConfig.cmake/arrow-config.cmake），最终编译失败。Ubuntu 22能成功是因为其软件源提供的预编译wheel或系统依赖更适配当前Python版本。

解决方案 #

1. 先安装系统级Arrow开发依赖 #

在Dockerfile中先安装Debian官方源提供的Arrow开发包，再安装Streamlit：

FROM python:3.12-bookworm

# 更新源并安装Arrow开发依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    libarrow-dev \
    libparquet-dev \
    && rm -rf /var/lib/apt/lists/*  # 清理缓存减小镜像体积

WORKDIR /app

# 升级pip并安装Streamlit
RUN pip install --upgrade pip
RUN pip install streamlit

# 复制应用代码
COPY your_app.py .

EXPOSE 8501
CMD ["streamlit", "run", "your_app.py"]

2. 强制使用预编译wheel（避免源码编译） #

如果不想安装系统依赖，可以强制pip使用预编译的manylinux wheel，跳过源码编译步骤：

FROM python:3.12-bookworm

WORKDIR /app

# 强制使用预编译wheel安装pyarrow和Streamlit
RUN pip install --upgrade pip
RUN pip install --only-binary :all: pyarrow streamlit

COPY your_app.py .

EXPOSE 8501
CMD ["streamlit", "run", "your_app.py"]

3. 降级Python版本（临时兼容方案） #

Python 3.12属于较新版本，部分包的兼容性仍在完善中。如果上述方案无效，可以切换到Python 3.11的Debian镜像：

FROM python:3.11-bookworm

WORKDIR /app

RUN pip install --upgrade pip
RUN pip install streamlit

COPY your_app.py .

EXPOSE 8501
CMD ["streamlit", "run", "your_app.py"]

验证方法 #

构建镜像后运行容器，检查是否能正常启动Streamlit：

docker build -t streamlit-debian .
docker run -p 8501:8501 streamlit-debian

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