树莓派4 Docker容器调用PiHQCam遇picamera初始化错误求助

先梳理下你遇到的两个核心问题：构建镜像时的系统检测错误，以及运行时的MMAL组件初始化失败。下面一步步来解决：

一、解决构建时的ValueError: This system does not appear to be a Raspberry Pi错误 #

picamera模块会通过读取/proc/cpuinfo的硬件信息判断是否为树莓派，但Docker容器默认隔离了部分主机系统信息，导致检测失败。你可以通过两种方式绕过检测：

方法1：构建时设置环境变量 #

修改Dockerfile，在pip3 install步骤前添加环境变量，强制picamera跳过系统兼容性检测：

ENV PI_CAMERA_FORCE=1

方法2：挂载主机的/proc/cpuinfo到容器 #

在docker-compose.yml的camera服务中添加只读挂载，让容器能读取主机的树莓派硬件标识：

volumes:
  - /proc/cpuinfo:/proc/cpuinfo:ro

二、解决运行时的PiCameraMMALError: Failed to create MMAL component b'vc.camera_info': I/O error #

这个错误源于底层VC（VideoCore）组件无法访问共享内存和设备，需要调整容器权限与挂载配置：

1. 完善Dockerfile依赖 #

balenalib的基础镜像缺少树莓派相机所需的底层库，需补充安装：
修改Dockerfile的apt-get install部分：

RUN apt-get update && \
    apt-get upgrade -y && \
    apt-get install -y python3 \
    python3-pip \
    libraspberrypi-bin \
    libraspberrypi-dev

这些包包含了MMAL组件依赖的底层驱动与工具。

2. 调整docker-compose的设备与权限配置 #

除了挂载/dev/vchiq，还需添加共享内存挂载、特权模式（或精细权限控制）：
更新后的docker-compose.yml：

version: '3.8'
services:
  camera:
    build: camera
    image: eye_camera
    devices:
      - /dev/vchiq:/dev/vchiq
      - /dev/vc-mem:/dev/vc-mem
    volumes:
      - /dev/shm:/dev/shm  # 挂载主机共享内存，解决MMAL的shm初始化失败问题
    privileged: true  # 赋予容器访问底层硬件的特权（若觉得权限过大，可替换为下方精细权限）
    # 替代privileged的精细权限配置：
    # cap_add:
    #   - SYS_RAWIO
    #   - DAC_OVERRIDE

3. 验证主机设备权限 #

在树莓派主机上，确保/dev/vchiq的权限允许容器内用户访问：

sudo chmod 660 /dev/vchiq
sudo usermod -aG video $USER  # 确保主机当前用户加入video组

容器内的用户已加入video组，这样就能正常访问属于该组的/dev/vchiq设备。

4. 临时排查：用root用户运行容器 #

如果以上配置仍有问题，可以先临时注释Dockerfile中创建普通用户的代码，用root用户运行容器，排除权限问题：

# RUN groupadd -r -g 888 app && \
#     useradd -r -u 888 -g app -d /app app && \
#     chown -R app:app /app && \
#     usermod -a -G video app
# USER app

若root用户能正常运行，再回头调试普通用户的权限配置。

三、最终配置示例 #

Dockerfile #

FROM balenalib/rpi-raspbian:latest
ENV PI_CAMERA_FORCE=1
RUN apt-get update && \
    apt-get upgrade -y && \
    apt-get install -y python3 \
    python3-pip \
    libraspberrypi-bin \
    libraspberrypi-dev
WORKDIR /app
COPY requirements.txt .
RUN pip3 install -r requirements.txt
COPY . .
RUN groupadd -r -g 888 app && \
    useradd -r -u 888 -g app -d /app app && \
    chown -R app:app /app && \
    usermod -a -G video app
USER app
CMD ["python3", "./main.py"]

docker-compose.yml #

version: '3.8'
services:
  camera:
    build: camera
    image: eye_camera
    devices:
      - /dev/vchiq:/dev/vchiq
      - /dev/vc-mem:/dev/vc-mem
    volumes:
      - /dev/shm:/dev/shm
    privileged: true

按照以上配置重新构建并运行容器，应该就能正常访问PiHQCam了。

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