【ESP32】 内存泄漏Debug方法

    ESP32 是 Espressif 设计的，在物联网应用中非常流行的 Wi-Fi / Bluetooth(BLE) 双模芯片，其开源IDF的方式也在开发者社区(Github)具有重要的影响力。对于程序设计而言，也相当友好。而内存泄漏作为一个非常常见的问题被相当多的朋友遇到，它关乎代码逻辑是否正确、以及最重要的——是否细心...好了，废话不多说，本文主要介绍一种 ESP32 提供的一种可以迅速、准确定位内存泄漏的方法。

    在介绍定位为方法之前，首先，用户应该正确地判断问题是否真的是内存泄漏。判断方法有两种：

1. ESP32的Bug打印；（运行时根据log打印判断）

2. 使用ESP操作系统的API：

esp_get_free_heap_size()

打印出当前内存剩余情况，可以在代码的开始和结束两处代码分别打印，并根据代码本身的功能状况进行判断。
 

printf("%s buffer get: %d\n",__func__,  esp_get_free_heap_size()); 

经过上面的判断，若问题真的由内存泄漏导致，那么可以进行以下操作:

1. 配置Heap Trace：

a. 在Terminal 进入配置界面： $ make menuconfig

b. 在 component -> Heap Memory Debugging 选项如下图进行配置：

2.在代码开始处进行以下操作：

 

/* 需要包含的 头文件 以及 宏定义 */
               
#ifdef CONFIG_HEAP_TRACING
    #include 
    #define NUM_RECORDS 100
    static heap_trace_record_t trace_record[NUM_RECORDS]; // This buffer must be in internal RAM
#endif

...

/* 代码开始处 */
ESP_ERROR_CHECK(heap_trace_init_standalone(trace_record,NUM_RECORDS));
ESP_ERROR_CHECK(heap_trace_start(HEAP_TRACE_LEAKS));

...

 在代码报错处加以下代码：

/* 代码出错处 */
...

printf("%s buffer get: %d\n",__func__,  esp_get_free_heap_size());
ESP_ERROR_CHECK(heap_trace_stop());
heap_trace_dump();

...

在Terminal内会精确到行数，并打印如下图：

后续便可以根据这个backtrace打印进行代码追踪，找到内存泄漏的地方。

=====================THE END=========================

如果觉得有用，请点赞、收藏、关注、或转发给你觉得有用的人。
本帐号会不定期记录与ESP-IDF调试小技巧，或者其他功能模块介绍。

LOVE AND SHARE.  PEACE.