invalid header: 0x：固件格式或 Flash 模式不匹配
ESP32-S3 常见问题 · 排查从第 L2 层开始
日志里常见的字样
invalid header: 0xflash read err, 1000这条报错说明什么
芯片读到的程序头不对，常见于用经典 ESP32 的固件烧到了 S3，或者 Flash 大小 / 模式选错。
先做这一步
确认编译时选择的是 ESP32S3 开发板，并按模组型号选择 Flash 大小（N8 = 8MB、N16 = 16MB）。
按顺序排查，别跳步
- L0供电：核对供电与指示灯
- L1连接：确认 USB、驱动与端口
- L2烧录：检查模式、工具与配置
确认目标型号和启动模式，记录完整烧录日志。 - L3最小程序：建立独立运行基线
- L4串口：确认运行日志
- L5外设：逐个验证接线和通信
ESP32-S3-DevKitC-1 的注意事项
- GPIO 不耐受 5V。
- 板载是 RGB 灯（WS2812），v1.0 在 GPIO48、v1.1 在 GPIO38；要用 neopixelWrite 点亮，digitalWrite 不会亮。
- N8R8 / N16R8（带八线 PSRAM）版本的 GPIO35–37 被 PSRAM 占用。
- 用原生 USB 口看串口日志时，Arduino IDE 需开启 USB CDC On Boot。
- GPIO0、3、45、46 影响启动，外设不能在上电时拉错电平。
相关问题
板伴 Boardly · 给硬件初学者的免费排错工具。内容依据公开资料整理，尚未逐条经过实物验证，请以实际测量为准。