为何内存超限时自定义vApplicationMallocFailedHook()未被调用？

核心原因 #

FreeRTOS中带__weak修饰的默认钩子函数，会在用户未提供正确声明/实现的自定义钩子时被调用。你的情况大概率是自定义钩子的声明、实现不符合FreeRTOS要求，或编译优先级导致默认版本被优先链接。

具体解决步骤 #

1. 严格匹配自定义钩子的函数签名 #

钩子函数必须完全遵循FreeRTOS的标准定义，不能添加额外修饰符：

void vApplicationMallocFailedHook( void );

• 禁止给函数加static等局部修饰符，否则编译器会将其视为局部函数，无法覆盖全局的__weak版本。

2. 配置FreeRTOSConfig.h关键宏 #

打开工程中的FreeRTOSConfig.h，确保以下宏正确定义：

• 启用内存分配失败钩子：

  #define configUSE_MALLOC_FAILED_HOOK    1
  

• 确认内存分配相关配置：
  • 若使用动态内存，configSUPPORT_DYNAMIC_ALLOCATION需设为1；
  • 检查configTOTAL_HEAP_SIZE的设置，确保测试代码的内存分配确实超出该值；
  • 若使用heap_1.c（仅分配不释放），内存耗尽会直接触发断言而非钩子，需切换到heap_2/3/4/5这类支持失败检测的堆实现。

3. 调整编译链接优先级 #

在STM32CubeIDE中，将包含自定义钩子的源文件（如freertos_hooks.c）的链接优先级调高：

1. 右键点击该文件 → Properties
2. 进入C/C++ Build → Settings → Tool Settings → MCU GCC Linker → Input
3. 在Additional objects中添加该文件的目标文件（如freertos_hooks.o），确保它在FreeRTOS库文件之前被链接。

4. 降低编译器优化等级测试 #

过高的优化等级（如-O3）可能导致编译器误判函数有效性，建议暂时切换到-O0或-O1测试，确认钩子正常触发后再调整优化等级。

5. 验证内存分配失败场景 #

确保测试代码确实触发了内存耗尽：

// 假设configTOTAL_HEAP_SIZE为16KB，尝试分配20KB触发失败
void *pTest = pvPortMalloc(20 * 1024);

内容的提问来源于stack exchange，提问作者Black_Cipher11th