ESP32引入ArduinoJson重构后添加代码即启动崩溃求助

问题详情 #

原本长期稳定运行的ESP32代码，在重构引入ArduinoJson库后，仅添加如Serial.print("TEST");这类简单代码就会触发设备启动即崩溃，且无业务代码执行迹象。

启动日志 #

16:06:18.253 -> rst:0x3 (SW_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
16:06:18.253 -> configsip: 0, SPIWP:0xee
16:06:18.253 -> clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
16:06:18.253 -> mode:DIO, clock div:1
16:06:18.253 -> load:0x3fff0030,len:1184
16:06:18.253 -> load:0x40078000,len:13260
16:06:18.253 -> load:0x40080400,len:3028
16:06:18.253 -> entry 0x400805e4
16:06:18.681 -> ets Jul 29 2019 12:21:46

程序存储占用情况 #

Sketch uses 1305157 bytes (99%) of program storage space. Maximum is 1310720 bytes.
Global variables use 56812 bytes (17%) of dynamic memory, leaving 270868 bytes for local variables. Maximum is 327680 bytes.

排查与解决思路 #

1. 紧急处理Flash空间溢出问题 #

从存储数据看，程序已占用99%的Flash空间，这是最核心的触发因素。ESP32 Flash接近满额时，链接阶段的内存布局会极度脆弱，哪怕添加一行极小的代码都可能打破平衡，导致启动时代码段加载失败或执行异常。

• 优化ArduinoJson使用：
  • 替换DynamicJsonDocument为StaticJsonDocument，减少库代码的Flash占用。
  • 关闭ArduinoJson中未用到的特性（比如浮点数解析、注释支持等），通过修改库配置或预编译宏实现。
• 精简程序体积：
  • 删除未使用的函数、冗余库依赖，合并重复逻辑。
  • 所有字符串常量用F()宏包裹（如Serial.print(F("TEST"));），将字符串存储到Flash而非RAM，同时节省Flash空间。

2. 排查ArduinoJson初始化异常 #

虽然动态内存剩余充足，但ArduinoJson的不当使用可能在启动阶段引发内存问题：

• 检查StaticJsonDocument的声明大小，过大的静态文档会占用过多全局内存，间接干扰启动流程。
• 避免在全局作用域初始化ArduinoJson相关对象，全局对象构造函数会在setup()前执行，此时内存布局不稳定易触发崩溃。

3. 验证启动流程完整性 #

日志显示进入入口地址后仅输出系统时间，说明程序未进入setup()，大概率是代码段加载或初始化出错：

• 启用ESP-IDF的Core Debugging功能，定位具体崩溃地址；若开启了核心转储，用esptool.py读取转储信息分析。
• 回滚到引入ArduinoJson前的稳定版本，逐步添加代码，定位触发崩溃的具体代码块。

4. 排除Flash硬件或写入异常 #

长期运行的设备可能存在Flash磨损，或新代码烧录时出现校验错误：

• 用esptool.py erase_flash擦除整个Flash后重新烧录程序。
• 尝试更换Flash芯片（若模块支持），排除硬件故障。

内容的提问来源于stack exchange，提问作者Luuk D. Jansen