板伴 / 故障知识库
单片机常见报错与故障知识库
按开发板分类，共 71 条。每条都写了报错的含义和第一步该做什么。
ESP32
- 供电不稳定 ·
Brownout - 未进入下载模式 ·
Timed out - Flash 访问或中断代码异常 ·
Cache disabled - 启动配置待检查 ·
invalid header - ADC2 与 Wi-Fi 使用冲突 ·
ADC2 - 输入引脚能力待核对 ·
GPIO3 4-9
ESP32-S3
- PSRAM 初始化失败 ·
PSRAM ID read error - 下载失败：未进入下载模式 ·
Failed to connect to ESP32-S3 - 固件格式或 Flash 模式不匹配 ·
invalid header: 0x
ESP32-C3
- 串口没有输出：没开「USB CDC On Boot」 ·
C3 - ESP32-C3 连不上：需要手动进入下载模式 ·
Failed to connect to ESP32-C3 - 端口消失或编号变了 ·
USB JTAG/serial debug unit
ESP32-CAM
- 摄像头初始化失败 ·
Camera init failed with error - ESP32-CAM 烧录失败：没进入下载模式 ·
Timed out waiting for packet header - PSRAM 没有启用或初始化失败 ·
psramInit : PSRAM init failed - microSD 卡挂载失败 ·
SD Card Mount Failed - 闪光灯自己亮或乱闪 ·
闪光灯
ESP8266
- 看门狗复位：程序卡住太久 ·
Soft WDT reset - 程序异常崩溃 ·
Exception - 启动模式不对 ·
boot mode: 1, - 下载失败：未进入下载模式 ·
Failed to connect to ESP8266
Arduino Uno / Nano / Mega（AVR）
- 上传失败：与 Bootloader 不同步 ·
stk500_getsync - 串口被占用或不存在 ·
can't open device - 读不到芯片签名 ·
Device signature = 0x000000 - RAM 不够用 ·
Low memory available - 程序超出 Flash 容量 ·
Sketch too big - Mega 2560 上传超时（stk500v2） ·
stk500v2_ReceiveMessage
树莓派 Pico / Pico W（RP2040）
- 上传失败：没有进入 BOOTSEL 模式 ·
No accessible RP2040 devices in BOOTSEL mode - 程序崩溃（HardFault / PANIC） ·
PANIC - MicroPython 缺库或内存不足 ·
ImportError: no module named - Pico W：LED 不亮或找不到 network 模块 ·
Pico W LED
STM32
- SWD 连接失败 ·
No target connected - 启动模式未确认 ·
下载成功 不运行 - 时钟配置待核对 ·
HSE 不起振 - UART 接线或配置问题 ·
串口 无输出 - LED 有效电平待确认 ·
PC13 不亮 - 调试引脚可能被占用 ·
重映射 - 芯片与工具配置不一致 ·
芯片 ID - 外设时钟或初始化缺失 ·
GPIO 没反应 - USB 固件或电路待核对 ·
USB 识别不到 - Flash 保护状态待检查 ·
读保护 - 电脑没有找到 ST-Link ·
No ST- LINK detected - ST-Link 连不上芯片（SWD 线路） ·
No Cortex- M SW Device Found - 芯片连得上但停不下来 ·
Cannot access target - Keil 写入 Flash 失败 ·
Flash Download failed - CubeIDE 调试启动失败 ·
Error in final launch sequence - 串口下载连不上 Bootloader ·
Failed to init device - 同一个函数被定义了两次 ·
L6200E - 函数找不到实现（库文件没加进工程） ·
L6218E - 找不到头文件 ·
cannot open source input file - 缺少芯片型号宏定义 ·
Please select first the target STM32F10x device - 程序太大，超出 Flash 或 RAM ·
L6406E - Keil 评估版 32 KB 限制 ·
L6050U - printf 卡死（半主机模式） ·
printf 卡死 - HAL_Delay 卡住不返回 ·
HAL_Delay 卡 - 程序跑飞进入 HardFault ·
HardFault_Handler
51 单片机（STC89C52）
- 等待 ISP 握手 ·
检测目标单片机 - ISP 配置待核对 ·
型号选错 - 串口线路待检查 ·
TX RX - 下载供电不稳定 ·
供电 - P0 上拉待检查 ·
P0 - 外设占用下载串口 ·
P3 0 - 晶振或机器周期配置不符 ·
延时不准 - 显示驱动与接线待核对 ·
数码管 - HEX 输出未生成 ·
空文件 - 启动硬件待检查 ·
烧录成功 不运行
所有开发板
- 串口未被识别 ·
no serial - 串口参数待核对 ·
乱码 - I²C 未发现设备 ·
no I2C - 先停止通电检查 ·
发热 - 缺少库或开发板选错（找不到头文件） ·
hh
编译时提示缺少 .h 文件？
「No such file or directory」缺少头文件：常用库的安装方法与开发板自带头文件的排查
直接分析你的日志把报错粘贴到板伴诊断工作台，自动匹配以上所有规则。板伴 Boardly · 给硬件初学者的免费排错工具。内容依据公开资料整理，尚未逐条经过实物验证，请以实际测量为准。