STM32F4网关实战：用ESP8266和LWIP搭建一个能存数据、带JWT认证的微型服务器
去年夏天，我接手了一个智能农业监测项目，需要在田间部署几十个数据采集节点。这些节点需要将温湿度数据实时上传到云端，但直接连接4G模块成本太高，WiFi覆盖又不稳定。于是我想到了用STM32F4开发板配合ESP8266搭建本地网关的方案——既能缓存数据，又能实现设备认证，成本还不到同类商业网关的三分之一。
1. 硬件选型与连接：为什么ESP8266依然是性价比之王
在评估了ESP32、W5500等多种网络模块后，我最终选择了老将ESP8266。这个决定基于三个实际考量：首先，项目中只需要2.4GHz WiFi无需蓝牙；其次，ESP8266的AT指令集经过多年迭代已非常稳定；最重要的是，它的价格还不到ESP32的一半，批量采购能省下可观成本。
硬件连接示意图：
STM32F407 ESP8266 3.3V --------- VCC GND --------- GND PA9 (TX) ----- RX PA10(RX) ----- TX这里有个容易踩坑的地方：ESP8266的RX引脚最高耐受3.3V电平，而STM32F4的某些型号TX引脚输出是5V电平。我在第一批原型机上就烧毁了三个ESP模块，后来通过添加电平转换电路解决了这个问题。如果使用STM32F4的USART1（PA9/PA10），记得在CubeMX中将GPIO模式设置为Alternate Function Push-Pull，并将Baud Rate设为115200——这是ESP8266 AT固件最稳定的通信速率。
2. LWIP协议栈配置：那些手册上没写的陷阱
在CubeMX中启用LWIP看似简单，但要让TCP/IP栈稳定运行需要特别注意以下参数配置：
/* lwipopts.h 关键配置 */ #define MEM_SIZE (12 * 1024) // 内存池大小，小于10K会导致频繁崩溃 #define TCP_WND (4 * TCP_MSS) // 窗口大小建议为MSS的4倍 #define TCP_SND_BUF (8 * TCP_MSS) // 发送缓冲区 #define LWIP_NETIF_LINK_CALLBACK 1 // 必须开启连接状态回调最令人头疼的是DHCP超时问题。在测试中发现，当路由器响应慢时，默认的DHCP超时时间（60秒）会导致整个系统卡死。我的解决方案是增加重试机制：
void ethernetif_notify(struct netif *netif) { if(netif_is_link_up(netif)) { if(!ip4_addr_isany_val(*netif_ip4_addr(netif))) { printf("IP: %s\n", ip4addr_ntoa(netif_ip4_addr(netif))); } else { dhcp_retry_count++; if(dhcp_retry_count < 3) { dhcp_start(netif); // 最多重试3次 } } } }3. 数据存储方案：在Flash和SD卡间找到平衡点
项目要求网关能在网络中断时缓存7天的数据（约10万条记录）。经过测试，STM32F4的内部Flash擦写寿命约1万次，显然不够用。最终采用的混合存储方案如下：
存储策略对比表：
| 数据类型 | 存储介质 | 更新频率 | 实现方式 |
|---|---|---|---|
| 设备配置 | 内部Flash | 极少 | HAL_FLASH_Program字节写入 |
| JWT令牌缓存 | FRAM | 每小时 | I2C接口循环写入 |
| 传感器原始数据 | microSD卡 | 每分钟 | FATFS文件系统+CSV格式 |
特别提醒：使用内部Flash存储时，务必先擦除整个扇区。我曾因为直接写入导致奇怪的内存错误：
void flash_write_config(uint32_t addr, uint8_t *data, uint16_t len) { HAL_FLASH_Unlock(); FLASH_EraseInitTypeDef erase = { .TypeErase = FLASH_TYPEERASE_SECTORS, .Sector = FLASH_SECTOR_5, // 必须与地址对应 .NbSectors = 1, .VoltageRange = FLASH_VOLTAGE_RANGE_3 }; uint32_t sector_error; HAL_FLASHEx_Erase(&erase, §or_error); for(uint16_t i=0; i<len; i+=4) { uint32_t word = *(uint32_t*)(data+i); HAL_FLASH_Program(FLASH_TYPEPROGRAM_WORD, addr+i, word); } HAL_FLASH_Lock(); }4. JWT认证实现：在资源受限设备上玩转加密
传统的JWT库如jansson在STM32上内存占用太大，最终我选择了开源库libjwt的精简版，通过以下优化将内存占用控制在8KB以内：
- 移除所有动态内存分配
- 预计算HS256签名所需的SHA256上下文
- 使用静态缓冲区替代malloc
令牌验证流程：
graph TD A[接收HTTP请求] --> B{含Authorization头?} B -->|否| C[返回401错误] B -->|是| D[提取JWT令牌] D --> E[验证签名有效期] E -->|无效| F[返回403错误] E -->|有效| G[解析payload] G --> H[检查设备权限] H -->|通过| I[执行请求]关键代码片段展示了如何验证令牌时效性：
int jwt_validate(const char* token, const uint8_t* key) { uint32_t now = get_timestamp(); jwt_claim_t claims[2] = { {.name="exp", .type=JWT_CLAIM_NUMBER, .value=&expiry}, {.name="dev", .type=JWT_CLAIM_STRING, .value=device_id} }; if(jwt_decode(&token, claims, 2, key, 32) != 0) { return -1; // 签名验证失败 } if(expiry < now) { return -2; // 令牌过期 } if(strcmp(device_id, allowed_devices) != 0) { return -3; // 设备未授权 } return 0; // 验证通过 }在实际部署中，建议采用令牌轮换机制：网关每6小时向云端申请新令牌，旧令牌在到期前1小时开始逐步淘汰。这既保证了安全性，又避免了大规模并发更新造成的网络拥堵。
5. 性能优化：从实验室到田野的实战经验
第一批网关部署后，发现了三个典型问题：
- 持续运行72小时后出现内存泄漏
- 高温环境下WiFi频繁断开
- 多设备并发访问时响应延迟
解决方案：
- 内存管理：改用LWIP的MEMPOOL替代malloc，增加内存统计线程：
void mem_monitor(void const *arg) { while(1) { printf("Free mem: %d/%d\n", lwip_stats.mem.avail, lwip_stats.mem.used); osDelay(5000); } }- 温度控制：通过PWM动态调节ESP8266供电电压，当芯片温度超过60℃时降频运行：
void temp_control() { float temp = read_temp_sensor(); if(temp > 60.0f) { HAL_GPIO_WritePin(GPIOE, GPIO_PIN_3, 0); // 关闭5V供电 osDelay(100); HAL_GPIO_WritePin(GPIOE, GPIO_PIN_3, 1); // 3.3V供电 at_send_command("AT+RFPOWER=10"); // 降低发射功率 } }- 并发处理：采用事件驱动架构替代轮询，关键配置：
#define LWIP_TCPIP_CORE_LOCKING 0 #define SYS_LIGHTWEIGHT_PROT 1 #define LWIP_NETCONN_SEM_PER_THREAD 1最终这个网关方案在30个农田监测点稳定运行了8个月，平均无故障时间超过2000小时。最令人惊喜的是，即便在雷雨天气导致网络中断72小时的情况下，所有数据都完整保存并在连接恢复后自动补传。
