SD Card Mount Failed：microSD 卡挂载失败

ESP32-CAM 常见问题 · 排查从第 L5 层开始

日志里常见的字样

SD Card Mount FailedCard Mount FailedNo SD Card attachedsdmmc failerror

这条报错说明什么

卡没插好、格式不对（需要 FAT32，32GB 以内最稳），或 SD 卡用到的 GPIO2/4/12/13/14/15 被别的外设占用。

用 FAT32 重新格式化；断开接在 GPIO2、4、12–15 上的其他东西；改用 1 线模式 SD_MMC.begin("/sdcard", true) 可以让 GPIO4 闪光灯不再跟着闪。

GPIO 不耐受 5V。供电是最大的坑：用 5V 2A 的电源接 5V 引脚；电脑 USB 口或 USB 转串口模块的 3.3V 经常带不动摄像头和 Wi-Fi，表现为反复重启（Brownout）。
没有 USB 口：烧录要用 USB 转串口模块（TX→U0R，RX→U0T，GND 共地，5V 供电），并把 GPIO0 接 GND 后按 RST 进入下载模式。用 ESP32-CAM-MB 底板可以省去接线。
板背面的红色 LED 在 GPIO33（低电平点亮，没有引到排针）；正面的白色大闪光灯在 GPIO4，非常亮，SD 卡 4 线模式也会用到它。
GPIO2、4、12、13、14、15 被 microSD 卡共用：用 SD 卡时这些引脚就不能接别的东西。
GPIO16 被 PSRAM 占用，不要接任何东西；GPIO12 上电时必须是低电平，否则 Flash 电压设置出错、无法启动。
排针上只有 ADC2 引脚，Wi-Fi 打开时 ADC2 不能用，所以这块板基本做不了模拟采样。
摄像头初始化失败（0x105 / 0x20001）通常是排线没插好，或代码里没选 CAMERA_MODEL_AI_THINKER。