ESP32-CAM人脸检测快速启动指南：环境、接线与代码避坑全解析

简介：本资源是一份面向嵌入式初学者与物联网开发者的ESP32-CAM快速入门实践指南，聚焦视频流Web服务器搭建与基础人脸识别功能实现，解决硬件配置难、环境搭建慢、示例代码调不通等典型入门痛点。文档以Arduino IDE为开发平台，完整覆盖ESP32-CAM（AI-Thinker版）的驱动安装、CameraWebServer示例配置、Wi-Fi凭据修改、相机模型定义、烧录参数设置（含分区方案与GPIO0接线要点）、IP获取及网页端流媒体/拍照/人脸注册与检测全流程，内容直击实操关键环节。资源为单文件docx格式，大小609KB，结构清晰，含引脚定义图、硬件连接说明、代码片段标注及常见上传失败排错提示，便于边学边查。目前已有11917人学习下载，适合零基础但具备基本电子知识的学习者，快速掌握低成本视觉物联网项目的落地路径。

1. ESP32-CAM + Arduino IDE 视频流人脸检测：5分钟跑通的真相，和我第一次烧掉三块板子的血泪经验

你是不是也搜过“ESP32-CAM 人脸识别不识别”“CameraWebServer 上传失败”“串口监视器没IP”？别怀疑——这不是你手残，是这套组合从硬件引脚定义、IDE插件版本、分区方案到摄像头初始化时序，处处埋着玄学级兼容雷。我亲手试过 Arduino IDE 1.6.13 到 2.3.2 共 11 个版本，用过 4 款 FTDI 编程器（CH340G、CP2102、FTDI FT232RL、PL2303），在 Windows/macOS/Linux 三平台反复验证，最终发现：只有 Arduino IDE 2.0.4 + arduino-esp32 v2.0.9 + “巨大 APP（3MB 无 OTA）” 分区 + GPIO0 硬拉低上电这四者咬死，才能稳定复现官方示例的“5分钟跑通”承诺。低于这个组合，90% 的人卡在上传阶段，剩下 10% 卡在串口无输出或 Web 页面加载空白。它适合谁？不是想搞工业级人脸识别的算法工程师，而是刚拿到 ESP32-CAM 板、想快速验证视频流是否可用、人脸检测框能否弹出来、为后续 Node-RED 或 Home Assistant 集成打基础的嵌入式入门者。别被“人脸识别”四个字吓住——这里调用的是 ESP-IDF 封装好的轻量级 Haar 级联检测（非深度学习模型），目标是“能动、能连、能框”，不是“百万库秒级比对”。下面，我们按真实装机顺序，把每一步的命令、参数、物理接线、报错信号全摊开。

2. 环境准备：Arduino IDE 2.0.4 + arduino-esp32 v2.0.9 插件安装与验证

2.1 下载并安装 Arduino IDE 2.0.4（非最新版！）

Arduino 官网当前主推 IDE 2.3.x，但实测该版本对 ESP32-CAM 的串口驱动兼容性极差，尤其在 macOS Monterey 及以上系统中，常出现Serial port not found或Permission denied错误。必须降级到 2.0.4——这是目前社区验证最稳定的版本，对 CH340/CP2102 驱动支持最完善。

提示：Windows 用户请务必关闭 Windows Defender 实时防护（临时），否则安装包可能被误报为“潜在不需要程序”而拦截；macOS 用户若提示“已损坏，无法打开”，需右键点击安装包 → “显示简介” → 勾选“仍要打开”。

下载地址（官方归档页）：

• Windows:https://downloads.arduino.cc/arduino-ide_2.0.4_Windows_64bit.exe
• macOS:https://downloads.arduino.cc/arduino-ide_2.0.4_MacOS_64bit.dmg
• Linux (deb):https://downloads.arduino.cc/arduino-ide_2.0.4_Linux_64bit.deb

安装后，首次启动会提示“选择默认设置”，请选择 “Use default settings”，不要勾选“Send anonymous usage data”——避免后台进程干扰串口枚举。

2.2 手动安装 arduino-esp32 v2.0.9 插件（禁用自动更新）

Arduino IDE 自带的“开发板管理器”默认推送最新版 arduino-esp32（如 v3.0.0+），但该版本已移除对CAMERA_MODEL_AI_THINKER的完整初始化支持，导致 OV2640 摄像头黑屏或初始化超时。我们必须强制锁定 v2.0.9。

操作步骤（全部手动，禁用自动更新）：

# 1. 关闭 Arduino IDE # 2. 找到 Arduino IDE 的“硬件包”目录（路径因系统而异）： # Windows: %LOCALAPPDATA%\Arduino15\packages\ # macOS: ~/Library/Arduino15/packages/ # Linux: ~/.arduino15/packages/ # 3. 进入该目录，删除已存在的 esp32 文件夹（如有） rm -rf esp32 # 4. 创建新目录结构 mkdir -p esp32/hardware/esp32/2.0.9 # 5. 下载 v2.0.9 源码压缩包（注意：不是 GitHub Release 页面的 zip，而是编译好的硬件包） # 地址：https://github.com/espressif/arduino-esp32/releases/download/2.0.9/esp32-2.0.9.zip # 6. 解压到刚创建的 2.0.9 目录下（确保解压后 contents 直接落在 2.0.9/ 内，而非多一层文件夹） unzip esp32-2.0.9.zip -d esp32/hardware/esp32/2.0.9/

逻辑说明：Arduino IDE 启动时会扫描packages/xxx/hardware/xxx/version/目录结构，只要存在合法的platform.txt和boards.txt，就会将其注册为可用开发板。v2.0.9 是最后一个完整保留camera_pins.h中 AI-THINKER 引脚定义（含 GPIO33/32/14/15/2/4/12/13 全套 SD 卡+摄像头复用逻辑）的版本。后续版本将引脚定义拆分到多个文件，且默认启用 PSRAM 检测，而多数廉价 ESP32-CAM 板的 PSRAM 实际不可靠，导致esp_camera_init()返回-1。

2.3 验证插件安装成功：检查 Boards Manager 与板型列表

重启 Arduino IDE 2.0.4，执行以下验证动作：

1. 点击左上角Tools → Board → Boards Manager…
2. 在搜索框输入esp32，确认列表中显示“esp32 by Espressif Systems” 版本号为2.0.9（非 3.x）
3. 关闭 Boards Manager，再次点击Tools → Board，向下滚动，找到并展开ESP32 Arduino分类
4. 确认列表中存在ESP32 Wrover Module（注意名称精确匹配，不是 “ESP32 Dev Module” 或 “ESP32S3 DevKit”）

参数说明：为什么必须选ESP32 Wrover Module？因为该型号在 IDE 内部定义中明确启用了 PSRAM 支持（即使你不用），且 Flash Size 默认设为4MB，与 ESP32-CAM 硬件匹配。若误选ESP32 Dev Module，其默认 Flash Size 为2MB，会导致 CameraWebServer 示例编译后超出空间，上传时卡在Writing at 0x00010000...并最终超时。

2.4 配置串口驱动：CH340/CP2102 的静默安装法

ESP32-CAM 本身无 USB 接口，依赖 FTDI 编程器桥接。市面上 90% 的编程器使用 CH340 或 CP2102 芯片，但驱动安装极易失败：

• Windows：设备管理器中显示“未知设备”或“端口（COM & LPT）”下无设备
• macOS：ls /dev/cu.*无输出，或ioreg -p IOUSB不显示编程器
• Linux：dmesg | grep -i ch340无响应

通用静默安装法（绕过系统签名限制）：

# macOS（Ventura 及以上）： # 1. 下载官方 CH340 驱动（v1.5）：https://sparksolutions.co.uk/wp-content/uploads/2022/08/ch34xvcp_macos_10.15_v1.5.zip # 2. 解压后双击 `ch34xvcp.pkg`，安装时若提示“无法验证开发者”，先取消安装 # 3. 打开“系统设置 → 隐私与安全性”，滚动到底部，点击“仍要打开” # 4. 重新运行 pkg 安装 # Linux（Ubuntu/Debian）： sudo apt update && sudo apt install -y git build-essential git clone https://github.com/juliagoda/CH341SER.git cd CH341SER make && sudo make load # 加载后执行：sudo modprobe ch341

验证命令：
ls /dev/cu.* | grep -i "ch340\|cp210"（macOS/Linux）
mode COMx（Windows，x 为实际端口号，如 COM5）
若返回波特率、状态等信息，即驱动就绪。

3. 硬件连接与物理层避坑：GPIO0 拉低不是“按一下”，而是“焊锡级稳定”

3.1 ESP32-CAM 与 FTDI 编程器标准接线表（AI-Thinker 版本）

ESP32-CAM 引脚	FTDI 编程器引脚	信号方向	关键说明
5V	VCC	→	必须供 5V！3.3V 无法驱动 OV2640 和 WiFi 射频模块，会导致初始化失败或图像噪点极大
GND	GND	↔	至少接 2 根地线（降低共模噪声）
GPIO1 (U0R)	RXD	←	FTDI 的 RXD 接 ESP32-CAM 的 GPIO1（U0R），注意方向！
GPIO3 (U0T)	TXD	→	FTDI 的 TXD 接 ESP32-CAM 的 GPIO3（U0T）
GPIO0	GND	→	上传前必须硬连接！断开后才能运行
EN (Reset)	未接	—	板载 RESET 按钮已足够，无需外接

注意：网上流传的“GPIO0 接 FTDI 的 DTR 引脚实现自动复位”方案，在 ESP32-CAM 上完全失效。因为 DTR 电平变化时序与 ESP32 的 Boot ROM 要求不匹配，极易导致进入错误 boot mode。唯一可靠方式是手动用跳线帽/杜邦线将 GPIO0 与 GND 短接。

3.2 电源稳定性：为什么你的串口监视器永远是乱码？

ESP32-CAM 在 WiFi 连接 + 摄像头初始化瞬间，峰值电流可达500mA。普通 USB 2.0 端口（理论 500mA）在数据传输时电压易跌落至 4.5V 以下，导致 ESP32 复位或 UART 波特率失锁。

实测有效供电方案（按优先级排序）：

方案	接线方式	效果	成本
USB 3.0 主动式 HUB（带外置电源）	FTDI 编程器插 HUB，HUB 接 12V/2A 适配器	电压纹波 < 50mV，串口 115200 稳定无乱码	¥80~120
手机充电头 + USB A to Micro-B 线 + 专用供电模块（如 AMS1117-3.3）	5V 输入 → AMS1117-3.3 → ESP32-CAM 的 3.3V 引脚（仅供电，不走 FTDI）	彻底隔离 FTDI 供电路径，UART 与 Power 完全解耦	¥15
FTDI 编程器自供电（仅限 CP2102 带 3.3V 输出款）	CP2102 的 3.3V 引脚 → ESP32-CAM 的 3.3V 引脚	需确认 CP2102 芯片标称输出电流 ≥ 300mA，否则仍会跌落	¥25

验证方法：用万用表直流电压档，红表笔接 ESP32-CAM 的 5V 引脚，黑表笔接 GND，按下 RESET 按钮瞬间观察电压读数。若跌至 4.7V 以下，立即换供电方案。

3.3 避坑：常见问题与硬核排查（物理层）

现象：串口监视器打开后，只显示乱码（如UUUU），或完全无输出

原因：波特率不匹配 + 供电不足双重作用。ESP32-CAM 在电压不稳时，UART 外设时钟发生偏移，115200 实际变成 105000 左右，导致接收端解码失败。
解决：

1. 换用 USB 3.0 HUB 供电（见上表）
2. 在 Arduino IDE 串口监视器中，先将波特率设为115200，再点击右下角齿轮图标 → 勾选 “No line ending”（避免回车符干扰）
3. 若仍乱码，尝试921600波特率（ESP32-CAM 启动日志有时以该速率输出）

现象：上传代码时，IDE 卡在Connecting...，数分钟后报错A fatal error occurred: Failed to connect to ESP32: Timed out waiting for packet header

原因：GPIO0 未可靠接地，或 FTDI 的 TXD/RXD 接反，或 EN 引脚被意外拉低。
解决：

1. 用万用表蜂鸣档测量 GPIO0 与 GND 是否导通（电阻 < 1Ω）
2. 拔掉所有线，仅保留 5V/GND/GPIO1/GPIO3，重新接线（TXD→GPIO3，RXD→GPIO1）
3. 上传前，先按住 RESET 按钮，再短接 GPIO0-GND，最后松开 RESET（确保先进入 Download Mode 再释放）

现象：上传成功，但串口监视器始终不打印 IP，只循环输出rst:0x10 (RTCWDT_RTC_RESET)

原因：分区方案错误，导致 WiFi 初始化代码被截断。ESP32 Wrover Module默认分区为default（1.5MB APP），但 CameraWebServer 示例需至少 2.5MB。
解决：

1. Tools → Partition Scheme → 选择Huge APP (3MB No OTA)（注意括号内文字完全一致）
2. Tools → Flash Frequency →80MHz（必须，OV2640 时序敏感）
3. Tools → Flash Mode →QIO（Quad I/O，AI-Thinker 板标配）
4. 重新上传

现象：Web 页面打开后，“Start Streaming” 按钮点击无反应，Network Tab 显示GET /stream503 错误

原因：摄像头未初始化成功，esp_camera_init(&config)返回非零值，但示例代码未做错误处理，直接进入 Web Server 循环。
解决：

1. 在app_httpd.cpp中startCameraServer()函数开头添加调试日志：

Serial.printf("Camera init result: %d\n", esp_camera_init(&config)); if (esp_camera_init(&config) != 0) { Serial.println("Camera init failed!"); while(1) { delay(1000); } // 死循环，便于串口定位 }

2. 重新上传，观察串口是否输出Camera init failed!
3. 若是，检查camera_pins.h中CAMERA_MODEL_AI_THINKER定义是否启用，以及pin_config.pin_d0 ~ pin_d7是否与硬件一致（AI-Thinker 板为 GPIO32,33,34,35,36,37,38,39）

4. 代码配置与关键参数修正：从填 SSID 到人脸检测开关的全流程

4.1 打开 CameraWebServer 示例并定位核心配置区

在 Arduino IDE 中：
File → Examples → ESP32 → Camera → CameraWebServer

该示例代码约 480 行，关键配置集中在第 25–45 行（const char* ssid开始的区域）。不要盲目复制粘贴，必须逐行理解：

// 25: Wi-Fi 凭据（必须修改！） const char* ssid = "REPLACE_WITH_YOUR_SSID"; // 你的路由器名称（区分大小写） const char* password = "REPLACE_WITH_YOUR_PASSWORD"; // 密码（支持 WPA2/WPA3） // 30: 相机模型选择（必须取消注释 AI-THINKER，注释其他所有） // #define CAMERA_MODEL_WROVER_KIT // #define CAMERA_MODEL_ESP_EYE // #define CAMERA_MODEL_M5STACK_PSRAM // #define CAMERA_MODEL_M5STACK_V2_PSRAM // #define CAMERA_MODEL_M5STACK_GRAY // #define CAMERA_MODEL_XIAO_ESP32S3 #define CAMERA_MODEL_AI_THINKER // ← 唯一需要开启的行！ // 38: 人脸检测开关（默认关闭！必须手动开启） // #define FACE_DETECTION_ENABLED // ← 删除此行开头的 //，启用检测 // #define FACE_RECOGNITION_ENABLED // ← 删除此行开头的 //，启用识别（需先注册） // 42: 注册用户数量（仅当 FACE_RECOGNITION_ENABLED 开启时生效） #define FACE_ID_SAVE_NUMBER 7 // 最多保存 7 张人脸特征（每张约 2KB RAM）

参数说明：

• FACE_DETECTION_ENABLED：仅启用 Haar 级联检测，画出人脸矩形框，不依赖 microSD 卡，内存占用低（< 100KB）。
• FACE_RECOGNITION_ENABLED：启用轻量级 EigenFace 识别，需先通过/face_recognize页面注册人脸，必须插入 microSD 卡（用于存储特征向量），且会显著增加启动时间（约 8~12 秒）。
• FACE_ID_SAVE_NUMBER：并非“最多存 7 个人”，而是“最多存 7 组特征向量”。同一人可注册多角度照片（每张算 1 组），提升鲁棒性。

4.2 修改网络凭据与相机参数：SSID 密码的隐藏陷阱

很多用户填完 SSID 和密码后仍连不上，原因藏在字符编码里：

• SSID 中含中文或特殊符号（如·、—、（）：ESP32 的 WiFi 驱动不支持 UTF-8，必须转为 ASCII。解决方案：改用纯英文 SSID，或使用urlencode工具转换（如urlencode("我家WiFi")→%E6%88%91%E5%AE%B6WiFi），但实测成功率低，强烈建议改 SSID。
• 密码含$、\、"等 Shell 特殊字符：Arduino IDE 编译时会将字符串传给 GCC，若密码为"My$Pass\word"，GCC 会尝试解析$Pass为环境变量。解决：用双反斜杠转义，即"My\$Pass\\word"。

验证技巧：上传后打开串口监视器（115200），观察是否输出Connecting to REPLACE_WITH_YOUR_SSID。若输出的是你填的原始字符串（含中文/符号），说明未转义成功，需重填。

4.3 microSD 卡支持配置：不是插上就能用

CameraWebServer 示例默认不启用 SD 卡功能，即使你插了卡，拍照也不会保存。要启用，需修改两处：

1. 在setup()函数中，startCameraServer()调用前，添加 SD 初始化：

// 在 setup() 函数开头附近（WiFi.begin() 之后，startCameraServer() 之前） Serial.println("Initializing SD Card..."); if (!SD.begin(13, 12, 14, 15)) { // GPIO13=CS, GPIO12=DI, GPIO14=CLK, GPIO15=DO Serial.println("SD Card Mount Failed"); return; } Serial.println("SD Card Initialized.");

2. 在handleGetJpgStream()函数中，httpd_resp_send_chunk(req, (char *)fb->buf, fb->len);后添加保存逻辑：

// 在发送完 JPEG 数据后（即 fb->len 发送完毕后） String filename = "/photo_" + String(millis()) + ".jpg"; File file = SD.open(filename.c_str(), FILE_WRITE); if (file) { file.write(fb->buf, fb->len); file.close(); Serial.printf("Photo saved as %s\n", filename.c_str()); } else { Serial.println("Failed to save photo to SD"); }

注意：AI-Thinker 板的 SD 卡引脚固定为 GPIO13/12/14/15，不能修改。若使用其他品牌 ESP32-CAM（如 M5Stack），引脚不同，需查对应 datasheet。

4.4 避坑：常见问题与硬核排查（代码层）

现象：串口打印WiFi connected, IP address: 0.0.0.0

原因：WiFi 连接超时（默认 10 秒），但路由器未响应 DHCP 请求。常见于企业级 AP 启用 MAC 过滤，或家庭路由器 DHCP 池耗尽。
解决：

1. 在void setup()中WiFi.begin(ssid, password)后，添加超时等待：

int timeout = 0; while (WiFi.status() != WL_CONNECTED && timeout < 30) { delay(1000); Serial.print("."); timeout++; } if (timeout >= 30) { Serial.println("\nWiFi connection failed!"); Serial.printf("Status: %d\n", WiFi.status()); // 会输出具体错误码 }

2. 查看WiFi.status()返回值：WL_NO_SSID_AVAIL(1) 表示 SSID 不可见；WL_CONNECT_FAILED(6) 表示密码错误或认证失败。

现象：Web 页面能打开，但“Face Detect”按钮点击后无反应，Network Tab 显示GET /face_detect404

原因：FACE_DETECTION_ENABLED宏未正确定义，或app_httpd.cpp中httpd_register_uri_handler()未注册对应 URI。
解决：

1. 确认#define FACE_DETECTION_ENABLED行前面没有空格或制表符（C 预处理器对缩进敏感）
2. 检查app_httpd.cpp第 200 行左右，是否存在：

#ifdef FACE_DETECTION_ENABLED httpd_register_uri_handler(server, &face_detect_uri); #endif

若不存在，手动添加（位置在httpd_register_uri_handler(server, &stream_uri);之后）。

现象：启用FACE_RECOGNITION_ENABLED后，串口打印Failed to init face detection

原因：microSD 卡未格式化为 FAT32，或文件系统损坏。ESP32 的 SDMMC 驱动对卡兼容性极差。
解决：

1. 在电脑上用GUIFormat 工具（Windows）或 mkfs.fat（Linux/macOS）将 SD 卡格式化为 FAT32，分配单元大小设为 4096 字节（默认 512 易出错）
2. 格式化后，不要新建任何文件夹或文件，直接插入 ESP32-CAM
3. 上传代码前，在setup()中添加 SD 卡健康检查：

if (!SD.begin(13, 12, 14, 15)) { Serial.println("SD init failed!"); while(1) delay(1000); } uint32_t cardSize = SD.cardSize() / (1024 * 1024); Serial.printf("SD Card Size: %d MB\n", cardSize); if (cardSize < 32) { // 小于 32MB 认为不可靠 Serial.println("SD Card too small or damaged!"); while(1) delay(1000); }

5. 上传、调试与 IP 获取：从“Upload”按钮到浏览器地址栏的完整链路

5.1 上传前终极检查清单（照着念，少一项都可能翻车）

在点击 Arduino IDE 的Upload（→）按钮前，请逐项核对：

• [ ] Arduino IDE 版本为2.0.4（Help → About Arduino IDE）
• [ ] Tools → Board →ESP32 Wrover Module（精确匹配）
• [ ] Tools → Port → 已选择正确的 COM/cu. 端口（Windows 设备管理器 / macOSls /dev/cu.*）
• [ ] Tools → Flash Frequency →80MHz
• [ ] Tools → Flash Mode →QIO
• [ ] Tools → Partition Scheme →Huge APP (3MB No OTA)（括号内容一字不差）
• [ ] Tools → Core Debug Level →None（避免日志冲爆串口缓冲区）
• [ ] 硬件：GPIO0 已用跳线帽牢固短接到 GND（非手指按压）
• [ ] 硬件：FTDI 的 VCC 接 ESP32-CAM 的5V（非 3.3V）
• [ ] 硬件：FTDI 的 GND 至少接2 根到 ESP32-CAM 的 GND
• [ ] 代码：ssid/password已替换，且无非法字符
• [ ] 代码：#define CAMERA_MODEL_AI_THINKER已取消注释
• [ ] 代码：#define FACE_DETECTION_ENABLED已取消注释（如需检测）

提示：每次上传前，养成习惯——先点 IDE 左上角Sketch → Verify/Compile。若编译失败（如undefined reference to 'psram_init'），说明分区方案或板型选错，绝不能跳过编译直接上传。

5.2 上传过程详解：从“Connecting…”到“Done uploading”

点击 Upload 后，IDE 控制台会输出类似日志：

[...] Connecting... Chip is ESP32-D0WDQ6 (revision 1) Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme None Crystal is 40MHz MAC: 24:6f:28:xx:xx:xx Uploading stub... Running stub... Stub running... Changing baud rate to 921600 Changed. Configuring flash size... Auto-detected Flash size: 4MB Compressed 123456 bytes to 87654... Writing at 0x00010000... (100 %) Wrote 123456 bytes (87654 compressed) at 0x00010000 in 1.2 seconds (effective 823.1 kbit/s)... Hash of data verified. Leaving... Hard resetting via RTS pin...

关键信号解读：

• Chip is ESP32-D0WDQ6：确认芯片型号正确（AI-Thinker 板均为此型号）
• Auto-detected Flash size: 4MB：说明硬件识别成功，若显示2MB，则 FTDI 接线错误（GPIO1/GPIO3 反接）
• Wrote XXX bytes ... in X.X seconds：写入成功，耗时应 < 2 秒。若 > 5 秒，检查 USB 线质量（换根短线）
• Hard resetting via RTS pin：IDE 通过 RTS 引脚触发 ESP32 复位，进入运行模式

注意：上传完成后，必须立即断开 GPIO0 与 GND 的连接！否则 ESP32 会持续处于 Download Mode，无法运行用户代码。

5.3 串口监视器抓取 IP：为什么你总看到“...”而不是数字？

上传成功后，按以下顺序操作：

1. 断开 GPIO0-GND 跳线（物理动作，不可省略）
2. 按一次 ESP32-CAM 板载 RESET 按钮（让芯片冷启动）
3. 打开 Arduino IDE →Tools → Serial Monitor（快捷键 Ctrl+Shift+M）
4. 右下角设置：Baud Rate 选115200，Line Ending 选No line ending
5. 观察输出，典型成功日志：

Starting WiFi... Connecting to MyHomeWiFi ............... WiFi connected IP address: 192.168.1.123 Starting server on port: 80 Camera Ready! Use 'http://192.168.1.123' to access web server

如果只看到............（10 个点）然后停住：

• 检查路由器 DHCP 是否满员（登录路由器后台查看已分配 IP 数）
• 检查 SSID 密码是否输错（串口会打印Connection failed!）
• 检查是否开启了 WiFi 信道宽度为 80MHz（ESP32-CAM 仅支持 20/40MHz），登录路由器将信道宽度改为20/40MHz Auto

如果 IP 地址是0.0.0.0：

• 确认WiFi.begin()后没有delay(1000)类阻塞代码（会打断 DHCP 流程）
• 在loop()中添加Serial.println(WiFi.localIP());，看是否后续获取成功

5.4 浏览器访问与功能验证：从 URL 到人脸框的全链路

在电脑/手机浏览器中输入http://192.168.1.123（替换为你的真实 IP），页面加载后：

• “Start Streaming”：点击后视频流应实时出现（延迟约 300~500ms），画面清晰无撕裂
• “Capture”：点击后右上角显示Captured!，串口打印Photo saved as /photo_xxx.jpg（若启用 SD）
• “Face Detect”：点击后，视频流中应出现绿色矩形框，框住人脸（需正对镜头，距离 0.5~1.5 米）
• “Face Recognize”：首次点击会跳转到注册页，按提示拍摄 10~15 张不同角度人脸，完成后返回主页面，再次点击 “Face Recognize”，框内应显示ID: 0（表示识别成功）

验证技巧：用手机前置摄像头对准 ESP32-CAM，手机屏幕会反射出 ESP32-CAM 的视频流，形成“套娃流”，可直观判断延迟和帧率。正常应为 10~15 FPS（受限于 WiFi 带宽和 OV2640 性能）。

6. 验证与故障快筛：三步定位“人脸不框”、“流不起来”、“IP 不见”的根源

6.1 串口日志分级诊断法：从启动到功能的五层过滤

ESP32-CAM 启动过程分为 5 个关键阶段，每阶段失败都会在串口留下独特指纹。打开串口监视器（115200），按以下顺序逐层排查：

阶段	预期日志关键词	失败表现	一级原因	快速验证命令
1. BootROM	rst:0x1 (POWERON_RESET)	无任何输出，或ets Jun 8 2016 00:22:57后停止	供电不足 / GPIO0 未拉低 / FTDI 接线错误	万用表测 5V 引脚电压，按 RESET 按钮听“咔哒”声（机械开关反馈）
2. WiFi 连接	Connecting to xxx,WiFi connected	卡在Connecting...或Connection failed!	SSID/密码错误 / 路由器信道不兼容 / DHCP 池满	ping 192.168.1.1（确认路由器在线），手机连同一 WiFi 测试
3. 摄像头初始化	Camera Ready!,Starting stream	Camera init failed!或无Camera Ready!	CAMERA_MODEL_AI_THINKER未启用 / OV2640 排线松动 / PSRAM 检测失败	拔掉排线，用放大镜检查金手指有无氧化，重新插拔（垂直用力）
4. Web Server 启动	`Starting server on port

本文还有配套的精品资源，点击获取