树莓派Zero W在Docker容器中访问SPI设备（MFRC522）遇权限拒绝

核心原因 #

SPI设备的权限由宿主机udev规则管理，容器内直接修改设备权限无效，需通过用户组映射让容器进程获得访问权限。

解决方案步骤 #

1. 宿主机确认SPI已启用 #

• 运行sudo raspi-config，进入Interface Options -> SPI，选择启用后重启树莓派。
• 或直接编辑/boot/config.txt，添加dtparam=spi=on，保存后执行sudo reboot。

2. 获取宿主机SPI用户组GID #

SPI设备默认归属spi用户组，运行以下命令查看其GID：

cat /etc/group | grep spi

输出类似spi:x:998:，其中的998就是需要用到的组ID（若你的输出不同，以实际数值为准）。

3. 修改docker-compose.yml配置 #

在controller服务中添加用户组映射，确保容器内进程拥有SPI访问权限：

version: '3.8'

services:
  controller:
    build:
      context: .
      dockerfile: Dockerfile_controller
    privileged: true
    group_add:
      - "998"  # 替换为你查到的spi组GID
    volumes:
      - /lib/modules:/lib/modules
      - /sys:/sys
      - /dev/spidev0.0:/dev/spidev0.0  # 仅挂载所需SPI设备，无需全量/dev
    devices:
      - /dev/gpiomem
      - /dev/gpiochip0

4. 优化Dockerfile依赖安装（可选） #

Alpine镜像可能缺少SPI相关编译依赖，可在Dockerfile中补充：

FROM python:3.9-alpine

WORKDIR /usr/src/app

# 安装编译依赖
RUN apk add --no-cache gcc musl-dev linux-headers

COPY controller/requirements.txt ./
RUN pip install --index-url=https://www.piwheels.org/simple --no-cache-dir -r requirements.txt

COPY controller .

CMD ["python", "controller.py"]

5. 验证权限 #

启动容器后，进入终端检查SPI设备权限：

docker exec -it <container-name> ls -l /dev/spidev0.0

此时root用户应已加入spi组，拥有设备读写权限。

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