Docker部署rpi-rgb-led-matrix库失败：core.cpp缺失求助

问题分析 #

报错中rgbmatrix/core.cpp: No such file or directory的核心原因是：该文件由Cython从core.pyx生成，若仓库子模块不完整、构建顺序错误或64位环境兼容性问题，会导致Cython无法生成该文件。

修复方案 #

1. 确保仓库子模块完全拉取

虽然你用了git clone --recursive，但部分镜像环境下可能存在子模块拉取不完整的情况，需补充强制更新步骤：

RUN git clone --recursive https://github.com/hzeller/rpi-rgb-led-matrix.git
WORKDIR /rpi-rgb-led-matrix
# 强制更新所有子模块，避免遗漏依赖
RUN git submodule update --init --recursive --force

2. 调整构建顺序，先触发Cython生成core.cpp

原Dockerfile中直接执行setup.py build_ext，但未确保Cython已处理.pyx文件。需先安装Cython依赖，并显式触发Cython编译：

# 在安装依赖阶段确保Cython正确安装
RUN apt-get update && apt-get install -y \
    git python3 python3-pip python3-dev cython3 \
    build-essential g++ curl cmake \
    libgraphicsmagick++-dev libboost-python-dev \
    libboost-system-dev
# 提前安装Cython的Python包
RUN pip3 install cython

3. 适配64位环境的构建参数

树莓派4 64位环境下，需在构建时指定ARCH=aarch64参数，避免编译时的架构不匹配：

WORKDIR /rpi-rgb-led-matrix
# 根目录构建时指定64位架构
RUN make clean && make -j$(nproc) ARCH=aarch64

4. 修改后的完整Dockerfile

FROM balenalib/raspberrypi4-64-debian:latest

# 安装基础依赖及Cython
RUN apt-get update && apt-get install -y \
    git python3 python3-pip python3-dev cython3 \
    build-essential g++ curl cmake \
    libgraphicsmagick++-dev libboost-python-dev \
    libboost-system-dev && \
    pip3 install cython && \
    apt-get clean && rm -rf /var/lib/apt/lists/*

# 克隆仓库并确保子模块完整
RUN git clone --recursive https://github.com/hzeller/rpi-rgb-led-matrix.git
WORKDIR /rpi-rgb-led-matrix
RUN git submodule update --init --recursive --force

# 64位架构下构建核心库
RUN make clean && make -j$(nproc) ARCH=aarch64

# 构建并安装Python绑定
WORKDIR /rpi-rgb-led-matrix/bindings/python
RUN python3 setup.py build_ext --inplace ARCH=aarch64
RUN python3 setup.py install

# 复制应用代码并启动
WORKDIR /app
COPY . /app
CMD ["python3", "display_gifs.py"]

5. 替代方案：使用预构建的镜像

若上述方法仍无效，可直接使用社区维护的预构建镜像，避免手动编译：

FROM ghcr.io/hzeller/rpi-rgb-led-matrix:latest
WORKDIR /app
COPY . /app
RUN pip3 install -r requirements.txt
CMD ["python3", "display_gifs.py"]

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