FreeType的FT_Render_Glyph()在ESP32上致全局变量内存损坏求助

问题描述 #

我在代码中集成了FreeType 2.13.2，Windows平台测试运行正常，但移植到ESP32后出现复位异常。定位后发现，首次调用FT_Render_Glyph()后，全局50字节char变量menustring会被损坏；跳过该API调用则一切正常。FT_Render_Glyph()是核心功能无法舍弃，求排查思路。

环境差异 #

• Windows编译器标准：std=C99
• ESP32编译器标准：std=gnu17
• 其他编译标志基本一致

内存地址映射 #

从.map文件可见，menustring与face变量地址非常接近：

.bss.menustring
                0x000000003fca2de0       0x32 esp-idf/main/libmain.a(mymain.c.obj)
                0x000000003fca2de0                menustring
 .bss.face      0x000000003fca2e18        0x4 esp-idf/main/libmain.a(mymain.c.obj)
                0x000000003fca2e18                face
 .bss.library   0x000000003fca2e1c        0x4 esp-idf/main/libmain.a(mymain.c.obj)
                0x000000003fca2e1c                library

复现代码 #

首次调用FT_Render_Glyph()后menustring100%损坏：

void showchar(char *textmsg)
{
    uint32_t glyph_index;

    glyph_index = FT_Get_Char_Index( face, *textmsg );
//    ESP_LOGI(TAG, "Showchar: do nothing just return, FT_Get_Char_Index returns %"PRIu32" for char %c", glyph_index, *textmsg);
//    return;

    if( glyph_index == 0 )
    {
        ESP_LOGI(TAG, "Showchar: FT_Get_Char_Index returns 0 for char %c", *textmsg);
        return;
    }

    if( FT_Load_Glyph(face, glyph_index, 0) )
    {
        ESP_LOGI(TAG, "Showchar: FT_Load_Glyph returns error for index %"PRIu32"", glyph_index);
        return;
    }
//    ESP_LOGI(TAG, "Showchar: do nothing just return, FT_Get_Char_Index returns %"PRIu32" for char %c", glyph_index, *textmsg);
//    return;

    if( FT_Render_Glyph(face->glyph, FT_RENDER_MODE_NORMAL) )
    {
        ESP_LOGI(TAG, "Showchar: FT_Render_Glyph returns error");
        return;
    }
    ESP_LOGI(TAG, "Showchar: do nothing just return, FT_Get_Char_Index returns %"PRIu32" for char %c, FT_Load_Glyph & FT_Render_Glyph returns 0", glyph_index, *textmsg);
    return;
}

排查思路与解决方案建议 #

• 检查FreeType内存分配适配：ESP32内存模型与Windows差异大，确保FreeType使用ESP-IDF提供的malloc/free实现，而非自定义内存分配器。可检查编译时FT_MEMORY相关宏定义是否正确配置。
• 验证FT_Face结构体内存完整性：face指针指向的FT_FaceRec结构体可能存在越界写。打印sizeof(FT_FaceRec)确认结构体大小，检查FT_New_Face()是否分配了足够内存。
• 修正结构体对齐差异：std=C99与std=gnu17的结构体对齐规则可能不同，导致FreeType结构体内存布局偏移。尝试在ESP32编译时添加-fpack-struct参数，或重新编译FreeType时使用一致的对齐规则。
• 开启内存越界检测：启用ESP-IDF的CONFIG_HEAP_TRACING或CONFIG_MEMLEAK_DETECTION功能，定位FT_Render_Glyph()内部的越界写操作；也可通过gdb断点调试，观测menustring内存变化。
• 替换为ESP-IDF适配版FreeType：尝试使用ESP-IDF官方组件库中的FreeType组件（idf.py add-component freetype），替换自行编译的版本测试是否解决问题。

内容的提问来源于stack exchange，提问作者Chris. Kan