树莓派4运行Streamlit应用时出现非法指令崩溃问题求助

问题根源 #

树莓派4采用ARMv8-A架构，PyPI官方提供的部分Pandas/NumPy wheel是针对更高阶ARM指令集编译的，导致运行时触发Illegal instruction (core dumped)错误。

可行解决方案 #

方案一：复用系统兼容版Pandas/NumPy（最简方案） #

利用树莓派系统仓库预编译的兼容版Pandas/NumPy，让虚拟环境可以访问这些系统包：

1. 安装系统级依赖：

sudo apt update && sudo apt install -y python3-pandas python3-numpy python3-venv

2. 创建带系统site-packages访问权限的虚拟环境：

python3 -m venv .venv --system-site-packages

3. 激活环境并安装Streamlit：

source .venv/bin/activate
pip install streamlit

4. 运行应用：

streamlit run main.py

方案二：强制使用PiWheels兼容包（纯虚拟环境方案） #

PiWheels提供专门为树莓派等ARM设备编译的Python包，强制pip使用这些包即可避免指令集问题：

1. 配置pip优先使用PiWheels并清除缓存：

pip config set global.index-url https://www.piwheels.org/simple
pip cache purge

2. 安装经过验证的兼容版本（版本号可根据需求调整，确保PiWheels上有对应ARM64包）：

pip install numpy==1.26.4 pandas==2.2.2

3. 安装Streamlit：

pip install streamlit

方案三：Docker环境适配 #

使用ARM64架构的基础镜像，配合PiWheels构建兼容容器：
创建Dockerfile：

FROM python:3.11-slim-bookworm

WORKDIR /app

# 安装编译依赖
RUN apt update && apt install -y --no-install-recommends \
    build-essential \
    libatlas-base-dev \
    gfortran \
    && rm -rf /var/lib/apt/lists/*

# 强制使用PiWheels
RUN pip config set global.index-url https://www.piwheels.org/simple

# 安装依赖
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

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

CMD ["streamlit", "run", "main.py", "--server.port", "8501"]

创建requirements.txt：

numpy==1.26.4
pandas==2.2.2
streamlit

构建并运行容器：

docker build -t streamlit-pi-app .
docker run -p 8501:8501 streamlit-pi-app

为什么之前的尝试失败？ #

• 方案2失败是因为默认虚拟环境会隔离系统site-packages，需添加--system-site-packages参数才能访问apt安装的Pandas；
• 方案4仅添加extra-index-url，pip仍可能优先选择PyPI的不兼容包，改为index-url强制使用PiWheels才能生效；
• 源码构建失败是因为树莓派CPU/内存资源有限，且编译NumPy/Pandas需要完整的依赖链，难度较高。

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