Erase失败常见问题与底层调试操作指南

Erase失败不背锅：一个嵌入式工程师的底层调试手记

你有没有遇到过这样的场景？OTA升级卡在“正在擦除Flash”这一步，进度条纹丝不动；JTAG一连上，发现FLASH_SR.BSY死死钉在1，EOP永远不置位；HAL函数返回HAL_ERROR，但没告诉你错在哪；重烧Bootloader、换芯片、甚至怀疑是批次不良——最后发现，只是Option Bytes里一个被遗忘的写保护位，或者nWP引脚上一颗虚焊的0Ω电阻。

这不是玄学，是Flash控制器在用它的方式“说话”。而我们常犯的错误，是只听API的翻译，却忘了去听硬件原声。

从一次真实的“假死”说起

去年调试一款基于STM32H743的工业网关时，客户反馈固件升级成功率不足60%。现场抓日志，发现所有失败案例都停在同一个位置：

if (HAL_FLASHEx_Erase(&erase_cfg, &sector_error) != HAL_OK) { LOG_ERR("Erase failed at sector %d", erase_cfg.Sector); goto fail; }

HAL返回HAL_ERROR，但sector_error始终为0——意味着HAL压根没走到错误分支，而是超时退出了。用ST-Link Utility手动擦除同一扇区却完全正常。问题显然不在Flash物理损坏，而在某处“看不见”的状态耦合。

最终定位：Bootloader在前一次升级中断电后遗留了PGERR=1，但新版本启动时未做FLASH_SR清零，导致后续所有Erase命令被控制器静默丢弃——BSY不置位、EOP不触发、也不报错，就像没人按响门铃，门却一直不开。

这个坑，手册里写了，但藏在第127页“错误标志清除”小节；HAL库里有接口，但默认不调用；经验老道的同事会说“记得清标志”，可没人告诉你为什么必须写0x000000FA，而不是0x00000000。

我们缺的不是文档，是一套能穿透抽象层、直连寄存器脉搏的调试本能。

Flash控制器不是黑盒，而是一台精密的老式机械钟表

别被“控制器”这个词唬住。它没有AI，不搞预测，不优化路径——它就是一台靠齿轮咬合推进的状态机，每一步都刻在硅片上，严丝合缝，也冷酷无情。

以STM32H7为例，Erase操作的本质，是向硬件发送一组不可逆的高压脉冲指令，并严格等待三件事发生：

1. 脉冲发出去了（FLASH_CR.PER = 1）
2. 脉冲执行中（FLASH_SR.BSY == 1）
3. 脉冲执行完且校验通过（FLASH_SR.EOP == 1 &&