如何修复树莓派Docker容器中'AttributeError: module 'board' has no attribute 'D5'错误

错误信息 #

Traceback (most recent call last):
  File "/home/ZDM1YTg4/lab.py", line 16, in <module>
    CS = DigitalInOut(board.D5)
                      ^^^^^^^^
AttributeError: module 'board' has no attribute 'D5'

出错代码段 #

from digitalio import DigitalInOut, Direction
import board
import busio
import adafruit_rfm9x
import time
import sys


FREQUENCY = 433.0  

CS = DigitalInOut(board.D5)  
RESET = DigitalInOut(board.D22) 
spi = busio.SPI(board.SCK, MOSI=board.D10, MISO=board.D9)
rfm9x = adafruit_rfm9x.RFM9x(spi, CS, RESET, 433.0)
rfm9x.irq = DigitalInOut(board.D2)

注：脚本在树莓派本机（容器外）运行正常，已尝试pip3 install --force-reinstall adafruit-blinka，问题未解决。

解决方案 #

• 确保容器具备GPIO硬件访问权限
  运行容器时必须挂载树莓派的GPIO相关设备文件，否则Blinka无法识别硬件引脚。执行容器时添加以下参数：

  docker run --privileged -v /dev/gpiomem:/dev/gpiomem -v /dev/mem:/dev/mem -it your-container-image
  

  若不想使用--privileged（权限过大），可改用精细设备映射：

  docker run --device /dev/gpiomem --device /dev/mem -it your-container-image
  

• 强制指定Blinka的硬件类型
  容器环境可能无法自动检测树莓派硬件，需手动设置环境变量让Blinka识别为树莓派：

  • 临时生效：运行脚本前执行

    export BLINKA_RASPBERRYPI=1
    

  • 永久生效：在Dockerfile中添加

    ENV BLINKA_RASPBERRYPI=1
    

• 验证Python环境与库的匹配性
  确认容器内的Python解释器和blinka库的安装路径一致：

  1. 查看blinka安装路径：

     pip3 show adafruit-blinka
     

  2. 检查脚本使用的Python版本：

     which python3
     

     若路径不匹配，需用对应版本的pip重新安装，比如python3.9 -m pip install adafruit-blinka

• 检查容器内GPIO设备的可访问性
  在容器内尝试读取GPIO设备文件，验证硬件访问是否正常：

  # 导出GPIO5引脚
  echo 5 > /sys/class/gpio/export
  # 读取引脚状态
  cat /sys/class/gpio/gpio5/value
  

  若操作失败，说明容器的硬件权限仍未配置正确。

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