V4L2采图程序多次运行后执行VIDIOC_DQBUF出队缓冲区时程序与相机冻结问题排查

卡死核心原因 #

• 代码存在硬语法错误：设置像素格式的语句中，imageFormat.fmt.pix.pixelformat - V4L2_PIX_FMT_MJPEG; 误用减号作为运算符，实际是无意义的算术表达式，完全未给像素格式字段赋值。由于该结构体是栈上未初始化的局部变量，pixelformat字段取值为内存随机值，向驱动传入非法帧格式请求，直接打乱A4tech相机对应的UVC驱动内部状态机。
• 栈上结构体未清零初始化：所有用于ioctl调用的栈上V4L2结构体，未赋值的保留字段全部是随机内存值，长期运行/多次调用后会触发驱动的参数校验异常，进入不可恢复的错误分支。
• 缓冲区配置不符合UVC驱动要求：代码仅申请1个采集缓冲区，绝大多数USB UVC摄像头的流式采集至少需要2~3个缓冲区才能正常完成帧流转。单缓冲区模式下，一旦驱动内部的USB异步传输块（URB）丢失、帧同步出错，已提交的缓冲区永远无法被填充完成，VIDIOC_DQBUF作为默认阻塞调用，会一直等待帧就绪，程序完全无响应。
• 异常退出残留驱动状态：当使用Ctrl+C强制终止程序时，代码没有机会执行VIDIOC_STREAMOFF、释放mmap映射的清理流程，驱动侧会残留上一次的流状态、缓冲区队列信息。再次打开设备时，驱动不会主动复位该异常状态，直接进入等帧的死循环。
• A4tech入门USB摄像头的UVC驱动鲁棒性较差，遇到非法格式请求、队列状态错位时不会自动从错误状态恢复，必须通过USB设备重枚举（也就是物理拔插相机）才能重置硬件和驱动的全部内部状态，这也是拔插操作可以临时恢复的根本原因。
• 阻塞调用无超时兜底：代码未给文件描述符设置非阻塞模式，也没有为VIDIOC_DQBUF调用设置等待超时，一旦驱动无帧返回，程序会无限等待，没有任何错误上报。

具体修复步骤 #

• 修正硬语法错误：将像素格式设置行的减号改为赋值等号，即：imageFormat.fmt.pix.pixelformat = V4L2_PIX_FMT_MJPEG;
• 所有用于ioctl调用的栈上V4L2结构体，使用前全部用memset清零，避免随机内存值传入驱动。设置完图像格式后，打印驱动实际返回的帧宽、高、像素格式、单帧大小，确认驱动实际生效的配置，不要默认使用自己传入的参数。
• 调整缓冲区配置：将请求的缓冲区数量从1改为3，依次遍历所有索引的缓冲区完成mmap映射，在启动流之前把所有缓冲区都提交到驱动队列，不要只提交单个缓冲区。
• 增加兜底机制：打开设备后可将文件描述符设置为非阻塞模式，对VIDIOC_DQBUF调用增加等待循环和超时判断，一旦超时就主动调用VIDIOC_STREAMOFF重置流状态，返回错误而非无限阻塞。增加SIGINT（Ctrl+C）信号处理逻辑，在进程被强制终止前优先执行流停止、设备关闭的清理操作，避免驱动残留异常状态。
• 修正文件写入逻辑：去掉冗余的分块拷贝循环，直接按bufferInfo.bytesused长度把mmap缓冲区的数据一次性写入文件，减少不必要的malloc/free操作，也避免越界读取的风险。
• 出现临时卡死时无需物理拔插相机，执行sudo rmmod uvcvideo && sudo modprobe uvcvideo 重新加载UVC驱动，即可重置所有相机的驱动状态。

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