PiCameraValueError：树莓派无头启动时320x240分辨率缓冲区长度错误

报错根因 #

树莓派无头模式下默认会关闭HDMI显示管线，GPU不会为显示上下文分配对应分辨率的内存块，PiCamera的默认缓冲区分配逻辑会读取当前显示上下文的分辨率参数，导致分配的缓冲区大小和你指定的320x240不匹配，因此抛出PiCameraValueError: Incorrect buffer length for resolution 320x240错误。有屏或者直接终端运行的时候，显示上下文处于激活状态，参数匹配因此不会报错。

解决方案 #

• 方案1：修改系统启动配置，强制激活显示上下文
  编辑/boot/firmware/config.txt（老版本系统路径为/boot/config.txt），添加以下配置：

  # 强制识别HDMI设备接入，避免关闭显示管线
  hdmi_force_hotplug=1
  hdmi_group=2
  hdmi_mode=87
  # 指定默认输出分辨率和摄像头使用的320x240对齐
  hdmi_cvt 320 240 60 1 0 0 0
  # 给GPU分配至少128M内存用于摄像头缓冲区
  gpu_mem=128
  

  修改完成后重启树莓派即可生效。
• 方案2：代码层面手动指定缓冲区参数，不依赖系统显示上下文
  初始化PiCameraStream前，手动完成摄像头实例的初始化和缓冲区锁定，示例代码如下：

  import time
  from picamera import PiCamera
  from picamera.array import PiRGBArray
  
  # 手动初始化摄像头，固定参数
  camera = PiCamera()
  camera.resolution = (320, 240)
  camera.framerate = 30
  # 手动分配固定大小的缓冲区，跳过动态适配显示上下文的逻辑
  raw_capture = PiRGBArray(camera, size=(320, 240))
  # 等待摄像头预热完成
  time.sleep(0.2)
  
  # 将手动初始化的摄像头实例传入PiCameraStream，不要使用自动初始化逻辑
  stream = PiCameraStream(camera=camera)
  

  如果你使用的是新版本picamera2库，需要在代码开头添加环境变量配置，关闭libcamera的显示依赖：

  import os
  os.environ["LIBCAMERA_HEADLESS"] = "1"
  

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