ESP32-CAM使用CameraWebServer人脸识别时出现EV-VSYNC-OVF错误求助

问题场景 #

使用AI Thinker ESP32-CAM开发板运行CameraWebServer示例程序，上传配置如下：

• Board: AI Thinker ESP32-CAM
• CPU Frequency: 240 MHz
• Flash Frequency: 80 MHz
• Flash Mode: QIO
• Arduino IDE版本：2.0.0
• esp32核心版本：2.0.14

代码可正常上传，但点击“enroll face”无任何反应，串口监视器持续输出EV-VSYNC-OVF报错，已尝试修改上传设置、config.frame_size和config.xclk_freq_hz参数，问题未解决。

解决步骤 #

1. 校准摄像头时钟与引脚映射 #

EV-VSYNC-OVF是摄像头垂直同步溢出错误，核心原因是时钟或引脚配置不匹配。AI Thinker ESP32-CAM搭载的OV2640摄像头必须使用特定参数：
打开CameraWebServer.ino，找到摄像头初始化的config结构体，确保以下参数完全匹配：

config.xclk_freq_hz = 20000000; // 固定为20MHz，旧款OV2640不支持更高频率
config.pin_pwdn = 32;
config.pin_reset = -1;
config.pin_xclk = 0;
config.pin_sscb_sda = 26;
config.pin_sscb_scl = 27;
config.pin_d7 = 35;
config.pin_d6 = 34;
config.pin_d5 = 39;
config.pin_d4 = 36;
config.pin_d3 = 21;
config.pin_d2 = 19;
config.pin_d1 = 18;
config.pin_d0 = 5;
config.pin_vsync = 25;
config.pin_href = 23;
config.pin_pclk = 22;

注：部分第三方ESP32-CAM模块引脚可能有差异，需对照硬件原理图确认。

2. 降低图像分辨率与优化格式 #

人脸识别模块对图像数据量敏感，过高分辨率会触发同步溢出：

• 将config.frame_size改为FRAMESIZE_QVGA（320x240），这是人脸识别的最低有效分辨率：

  config.frame_size = FRAMESIZE_QVGA;
  

• 添加以下配置减少数据负载：

  config.fb_count = 1; // 减少帧缓冲区数量，降低内存占用
  config.pixel_format = PIXFORMAT_GRAYSCALE; // 人脸识别仅需灰度图，大幅减少数据量
  

修改后重新上传代码，测试“enroll face”功能。

3. 调整帧缓存与抓取模式 #

若模块带PSRAM，优先将帧缓存移至PSRAM；无PSRAM则限制缓存数量：

config.fb_location = CAMERA_FB_IN_PSRAM; // 带PSRAM模块使用此配置
// 无PSRAM模块改为：config.fb_location = CAMERA_FB_IN_DRAM;
config.grab_mode = CAMERA_GRAB_WHEN_EMPTY; // 仅当缓冲区为空时抓取帧，避免溢出

4. 更新ESP32核心与IDE版本 #

当前使用的esp32核心2.0.14存在摄像头驱动bug，建议更新：

• 打开Arduino IDE的文件>首选项，确认附加开发板管理器网址包含https://dl.espressif.com/dl/package_esp32_index.json
• 进入工具>开发板>开发板管理器，搜索esp32并更新至最新稳定版（如3.x系列）
• 同时将Arduino IDE更新至2.x最新版，消除版本兼容问题

5. 排查硬件问题 #

• 重新插拔摄像头FPC排线，确保插紧无针脚弯曲
• 更换5V/2A以上的电源供电，供电不足会导致摄像头工作不稳定
• 尝试更换同型号OV2640摄像头模块，排除硬件故障

内容的提问来源于stack exchange，提问作者Mateus Viana Schmeing