基于FreeRTOS、netconn API的STM32F2 TCP服务器线程删除资源泄漏问题

我正在开发一款基于STM32F207ZG的定制板项目，目标是实现支持最多10个客户端同时连接的TCP服务器固件，核心功能包括：

• 采用客户端-服务器模型实现PC主机与板卡通信
• 接收数据请求报文
• 读写STM32F207ZG的GPIO引脚状态
• 返回操作结果报文

项目基于ST官方AN3384示例项目结构开发，单客户端模式运行正常。为实现多客户端支持，我在新连接到达时创建独立线程处理该客户端。

问题现象 #

• 初始状态下，客户端连接数达到5个后，第6个客户端无法建立连接；断开客户端后也无法创建新连接。
• 调试LWIP代码发现，netconn_recv返回ERR_MEM错误，原因是memp_malloc(MEMP_NETBUF)分配内存失败。

已尝试的改进 #

启用FreeRTOS RAM管理、增大堆空间后，可创建的客户端线程数从5提升至18，但核心问题仍未解决：调用vTaskDelete删除线程后，资源未有效释放，必须增大堆才能创建更多线程。项目当前编译heap_4.c作为内存管理文件，使用pvPortMalloc而非标准malloc。

疑问 #

线程删除未释放资源的情况下，删除前需执行哪些操作？请提供解决方案或相关建议。

1. 手动清理LWIP核心资源 #

FreeRTOS的vTaskDelete仅会释放线程自身的栈和任务控制块（TCB），LWIP的连接相关资源必须手动释放，步骤如下：

• 关闭当前客户端连接：调用netconn_close(conn)
• 销毁netconn结构体：调用netconn_delete(conn)
• 释放未处理的netbuf：如果线程内有接收后未处理的netbuf，必须调用netbuf_delete(buf)完成释放

2. 排查自定义内存泄漏 #

• 检查线程内所有用pvPortMalloc分配的内存（如自定义报文缓冲区、临时数据结构），确保在线程退出前调用vPortFree释放。
• 避免在循环中重复分配内存却不释放，比如每次处理报文都分配新缓冲区但未回收。

3. 调整LWIP内存池配置 #

打开lwipopts.h，调整以下参数以匹配10个并发客户端的需求：

• MEMP_NUM_NETBUF：至少设置为15（预留余量）
• MEMP_NUM_TCP_PCB：至少设置为12
• MEMP_NUM_TCP_SEG：根据报文大小调整，确保能容纳并发连接的报文数据
• 同时检查TCP_SND_BUF、TCP_WND等参数，避免因缓冲区不足导致的内存分配失败

4. 优化线程管理策略 #

• 改用线程池模式：预先创建10个客户端处理线程，通过消息队列分配新的客户端连接，避免频繁创建/销毁线程带来的资源开销和泄漏风险。
• 合理设置线程栈大小：使用uxTaskGetStackHighWaterMark函数检测线程栈的剩余空间，将栈大小调整到刚好满足需求的最小值，减少内存占用。

5. 验证FreeRTOS内存管理 #

• 启用heap_4.c的内存统计功能：可以在pvPortMalloc和vPortFree中添加计数逻辑，跟踪内存分配/释放情况，定位未释放的内存块。
• 定期打印系统内存使用情况，观察内存是否持续增长，确认泄漏点。

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