STM32F4通过ESP8266连接MQTT服务器：HAL库驱动与协议移植实战-编程实验室

简介：本资源是一套面向STM32F4系列开发者（尤其聚焦物联网应用）的MQTT通信实战代码库，解决基于HAL库与ESP8266 Wi-Fi模块实现稳定MQTT连接、主题订阅/发布及断线重连等核心问题。资源包共501个文件，涵盖131个C源码（含HAL驱动与MQTT协议栈实现）、128个头文件（定义接口与配置宏）、68个依赖描述文件（.d）、66个编译中间文件（.o）及配套工程文件（uvprojx/uvoptx）、调试配置（dbgconf）、固件镜像（hex/axf）和说明文档（txt），整体压缩后仅2.81MB，结构完整、可直接导入Keil MDK构建运行。已有1818人学习下载，提供从UART串口初始化、ESP8266 AT指令交互、MQTT客户端配置（服务器地址、认证参数）、心跳保活到事件回调处理的全链路函数封装，代码注释清晰、内存管理严谨，特别适合作为嵌入式IoT项目快速集成MQTT能力的参考范例。

1. 项目概述：当STM32F4遇上MQTT与ESP8266

最近在做一个物联网小项目，核心需求是把STM32F4采集到的传感器数据，稳定地发送到云端的MQTT服务器上。手头正好有块ESP8266的Wi-Fi模块，于是很自然地就想到了用STM32的HAL库去驱动ESP8266，然后通过MQTT协议进行通信。这个组合在物联网开发里非常经典，但真上手做，你会发现从硬件接线、AT指令调试，到MQTT库的移植和业务逻辑整合，每一步都有不少细节需要注意。网上资料虽然多，但往往比较零散，要么只讲AT指令，要么只讲MQTT协议，能把STM32 HAL库、ESP8266、MQTT库这三者串起来，讲清楚从零到一实现稳定通信的完整流程和避坑指南的并不多。今天我就把自己趟过的路、踩过的坑，结合HAL库的特点和MQTT的核心机制，系统地梳理一遍，目标是让你看完就能动手复现一个稳定的数据上报节点。

简单来说，这个项目就是利用STM32F4作为主控，通过串口（UART）以AT指令的方式控制ESP8266模块连接Wi-Fi并接入互联网，然后在STM32上运行一个轻量级的MQTT客户端库，通过ESP8266建立的TCP连接与远端的MQTT服务器（Broker）进行通信，实现数据的发布（Publish）和订阅（Subscribe）。整个过程，STM32是大脑，负责业务逻辑和协议处理；ESP8266是网卡，负责网络连接；MQTT是通信语言，负责高效、可靠的数据交换。

2. 核心组件选型与设计思路拆解

2.1 为什么是STM32F4 + HAL库 + ESP8266 + MQTT？

这个技术栈的选择，背后有非常实际的工程考量。首先，STM32F4系列基于Cortex-M4内核，主频高（通常168MHz），有足够的计算能力来流畅地解析AT指令、处理MQTT协议包，同时还能兼顾传感器采集等业务任务。它的外设资源，特别是多个UART，非常适合用来与ESP8266通信（占用一个UART）的同时，还能保留调试串口或连接其他设备。

选择HAL库而非标准库或LL库，主要是出于开发效率和可移植性的考虑。HAL库提供了更高层次的抽象，初始化、发送、接收、中断处理都有现成的函数，虽然代码体积稍大，但大大降低了开发门槛，让开发者能更专注于应用逻辑。尤其是在处理ESP8266这种需要频繁、不定长串口通信的场景，HAL库的串口空闲中断（IDLE Interrupt）配合DMA接收，能非常优雅地解决数据接收问题，这个后面会详细讲。

ESP8266模块几乎是物联网开发的“标配”了，价格低廉，集成度高，自带TCP/IP协议栈，通过简单的AT指令集就能完成网络连接。它把复杂的Wi-Fi和网络协议处理都自己搞定了，对STM32来说，它就像一个“串口转Wi-Fi”的透明桥，极大地减轻了主控的负担。

最后是MQTT协议。在资源受限的嵌入式设备上，像HTTP这样的协议就显得过于“重”了，头部信息多，连接开销大。MQTT是一种基于发布/订阅模式的轻量级消息协议，专为低带宽、高延迟或不稳定的网络环境设计。它的报文头部最小只有2字节，支持心跳保活、遗嘱消息、服务质量等级（QoS），非常适合电池供电或网络状况多变的物联网终端。用MQTT，我们的设备可以很轻松地把数据发布到指定主题（Topic），比如sensor/device01/temperature，服务器或其他订阅了该主题的设备就能收到消息。

2.2 MQTT客户端库的选择与考量

在STM32上实现MQTT，通常有两种路径：一是自己根据协议规范从头实现，二是使用现有的开源库。对于绝大多数应用，强烈建议选择后者。一个成熟、经过测试的MQTT库能帮你处理掉协议解析、重连、保活等繁琐且易出错的细节。

常见的嵌入式MQTT库有 Eclipse Paho 的嵌入式C客户端、MQTT-C、emqtt 等。这里我选择使用一个在STM32社区中比较流行、针对资源受限环境优化过的轻量级库，我们姑且称之为stm32_mqtt（在实际项目中，它可能是基于Paho或MQTT-C裁剪移植的）。选择它的理由如下：

内存占用小：经过裁剪，其RAM和ROM占用都非常适合STM32F4，通常只需要几KB的RAM。
接口简单：提供了清晰的初始化、连接、发布、订阅、断开等接口，与网络层（这里指通过ESP8266的TCP连接）解耦良好。
支持QoS 0和QoS 1：对于大多数传感数据上报（QoS 0）和需要确认的重要指令（QoS 1）都能满足。
平台适配性好：通常只需要实现几个底层的网络发送/接收函数和定时器函数，就能移植到任何平台上。

我们的系统架构因此变得清晰：应用层（我们的业务逻辑）调用MQTT库层的接口；MQTT库层需要依赖一个网络适配层，这个适配层的核心任务就是通过ESP8266建立并维护一个TCP连接，并提供send和recv函数给MQTT库调用；最底层是硬件驱动层，即STM32 HAL库驱动的UART与ESP8266通信。

3. 硬件连接与HAL库基础驱动搭建

3.1 ESP8266模块与STM32F4的硬件连接

ESP8266模块（如ESP-01S）通常有8个引脚，我们核心关注的是电源、地、串口和启动模式引脚。

VCC -> 3.3V：至关重要！ESP8266必须使用3.3V供电，接5V会烧毁模块。
GND -> GND：共地。
RX -> STM32的某个UART的TX引脚：STM32发送数据给ESP8266。
TX -> STM32的某个UART的RX引脚：STM32接收ESP8266的数据。
CH_PD (或EN) -> 3.3V：使能引脚，拉高模块才能工作。
GPIO0：启动模式选择。上电时，GPIO0悬空或拉高为正常启动模式（运行固件）；拉低则进入下载模式（烧录固件）。我们日常使用悬空即可。
GPIO2：通常需要上拉，悬空可能有问题，建议通过一个10K电阻上拉到3.3V。
RST：复位引脚，低电平有效。可以接STM32的一个GPIO以便软件复位，也可以直接上拉到3.3V。

接线完成后，务必先单独测试ESP8266。可以通过USB转TTL模块连接到电脑，用串口助手（如XCOM、SecureCRT）发送AT指令（如AT、AT+GMR）看是否有OK响应，确保模块本身和固件是好的。

3.2 基于HAL库的串口驱动配置要点

在STM32CubeMX中配置与ESP8266通信的UART（假设是USART2）：

模式选择为“Asynchronous”。
波特率设置为115200（这是ESP8266 AT固件最常见的波特率）。
字长8位，停止位1位，无校验。
关键步骤：开启串口全局中断和DMA接收。
- 在NVIC Settings中使能USART2的全局中断。
- 在DMA Settings中为USART2的RX添加一个DMA请求，模式设为“Circular”（循环模式）。这样，串口接收到的数据会通过DMA自动搬运到我们指定的缓冲区，不占用CPU。
生成代码。

在生成的代码中，我们需要在main.c或单独的驱动文件里完善接收逻辑。核心是利用串口空闲中断。

为什么用“串口空闲中断+DMA”？ESP8266的响应数据长度是不固定的。传统的“接收中断+字节超时”判断方式复杂且不可靠。串口空闲中断是指，当串口总线上一段时间（可配置）没有新的数据传输时，就会触发此中断。配合DMA，我们可以精确地知道一次AT指令响应何时完整到达。DMA负责把数据存到缓冲区，空闲中断告诉我们“数据收完了”，此时我们去处理缓冲区里的完整数据包，完美。

实现步骤：

定义一个接收缓冲区uint8_t esp8266_rx_buffer[512];和接收长度变量。
在main函数初始化后，启动串口DMA接收：HAL_UART_Receive_DMA(&huart2, esp8266_rx_buffer, 512);
开启串口空闲中断：__HAL_UART_ENABLE_IT(&huart2, UART_IT_IDLE);
在stm32f4xx_it.c的USART2_IRQHandler函数中，添加空闲中断处理：

void USART2_IRQHandler(void) { if(__HAL_UART_GET_FLAG(&huart2, UART_FLAG_IDLE) != RESET) { __HAL_UART_CLEAR_IDLEFLAG(&huart2); // 清除空闲中断标志 HAL_UART_DMAStop(&huart2); // 暂时停止DMA，防止数据被覆盖 // 计算本次接收到的数据长度 uint16_t len = 512 - __HAL_DMA_GET_COUNTER(&hdma_usart2_rx); if(len > 0) { // 在这里，esp8266_rx_buffer[0:len-1] 就是完整的AT响应数据 esp8266_data_handler(esp8266_rx_buffer, len); // 调用处理函数 } // 重新设置DMA指针和计数器，继续接收 HAL_UART_Receive_DMA(&huart2, esp8266_rx_buffer, 512); } HAL_UART_IRQHandler(&huart2); }

这样，我们就搭建了一个高效、可靠的ESP8266数据接收引擎。

4. ESP8266 AT指令驱动层实现

有了稳定的收发基础，接下来要封装一个用于控制ESP8266的驱动层。这个层的目标是向上提供简单的接口，如ESP8266_ConnectWiFi()，ESP8266_ConnectTCPServer()。

4.1 AT指令发送与响应解析框架

首先，我们需要实现一个基本的AT指令发送和等待响应的函数。这里的关键是超时机制和响应判断。

typedef enum { ESP8266_OK, ESP8266_ERROR, ESP8266_TIMEOUT, ESP8266_BUSY } ESP8266_Status_t; ESP8266_Status_t ESP8266_SendCmdAndWaitResp(const char* cmd, const char* expected_resp, uint32_t timeout_ms) { // 1. 清空接收缓冲区（可以通过重置DMA计数器实现） // 2. 通过HAL_UART_Transmit发送AT指令，末尾加上\r\n HAL_UART_Transmit(&huart2, (uint8_t*)cmd, strlen(cmd), 100); HAL_UART_Transmit(&huart2, (uint8_t*)"\r\n", 2, 100); // 3. 记录开始时间 uint32_t start_tick = HAL_GetTick(); // 4. 等待空闲中断处理函数设置“响应接收完成”标志位 // 通常我们需要一个全局变量，如 `g_esp8266_rx_done`，在空闲中断处理函数中解析到预期响应后置位。 while((HAL_GetTick() - start_tick) < timeout_ms) { if(g_esp8266_rx_done) { g_esp8266_rx_done = 0; if(g_esp8266_resp_status == RESP_OK) { // RESP_OK在解析函数中根据内容设置 return ESP8266_OK; } else { return ESP8266_ERROR; } } // 这里可以加入RTOS的延时或空闲任务切换，如果用了RTOS的话 // HAL_Delay(1); } return ESP8266_TIMEOUT; }

在空闲中断处理函数esp8266_data_handler中，我们需要解析接收到的数据，判断是否包含"OK"、"ERROR"或我们期待的特定响应（如"CONNECT"），并设置相应的状态标志。

4.2 关键网络功能实现：Wi-Fi连接与TCP建立

基于上面的框架，我们可以实现核心的网络连接函数：

连接Wi-Fi：

ESP8266_Status_t ESP8266_ConnectWiFi(const char* ssid, const char* password) { char cmd[128]; // 1. 设置模式为Station模式 snprintf(cmd, sizeof(cmd), "AT+CWMODE=1"); if(ESP8266_SendCmdAndWaitResp(cmd, "OK", 3000) != ESP8266_OK) return ESP8266_ERROR; HAL_Delay(500); // 模式切换后稍作延时 // 2. 连接AP snprintf(cmd, sizeof(cmd), "AT+CWJAP=\"%s\",\"%s\"", ssid, password); // 连接Wi-Fi时间较长，超时设置长一些，比如15秒 ESP8266_Status_t status = ESP8266_SendCmdAndWaitResp(cmd, "OK", 15000); // 3. (可选)获取IP地址确认 if(status == ESP8266_OK) { snprintf(cmd, sizeof(cmd), "AT+CIFSR"); ESP8266_SendCmdAndWaitResp(cmd, ".", 3000); // 响应中包含IP地址 } return status; }

建立TCP连接（连接到MQTT服务器）：假设我们的MQTT服务器地址是mqtt.bemfa.com，端口是9501（巴法云MQTT服务器示例）。

ESP8266_Status_t ESP8266_ConnectTCPServer(const char* host, uint16_t port) { char cmd[128]; // 1. 设置为单连接模式 snprintf(cmd, sizeof(cmd), "AT+CIPMUX=0"); if(ESP8266_SendCmdAndWaitResp(cmd, "OK", 3000) != ESP8266_OK) return ESP8266_ERROR; // 2. 建立TCP连接 snprintf(cmd, sizeof(cmd), "AT+CIPSTART=\"TCP\",\"%s\",%d", host, port); // 等待"CONNECT OK"或"OK"，连接超时可以设10秒 ESP8266_Status_t status = ESP8266_SendCmdAndWaitResp(cmd, "OK", 10000); // 3. 开启透传模式（非常重要！） if(status == ESP8266_OK) { snprintf(cmd, sizeof(cmd), "AT+CIPMODE=1"); if(ESP8266_SendCmdAndWaitResp(cmd, "OK", 3000) != ESP8266_OK) return ESP8266_ERROR; snprintf(cmd, sizeof(cmd), "AT+CIPSEND"); if(ESP8266_SendCmdAndWaitResp(cmd, ">", 3000) != ESP8266_OK) return ESP8266_ERROR; // 等待提示符'>' // 进入透传模式后，所有通过串口发送的数据都会直接通过TCP连接发送出去，接收到的TCP数据也会直接打印到串口。 g_esp8266_transparent_mode = 1; // 设置透传模式标志 } return status; }

进入透传模式后，ESP8266的串口就变成了一个透明的TCP管道。这时，我们STM32通过串口发送的任何数据，都会被ESP8266原封不动地发送到MQTT服务器；反之，从服务器来的任何数据也会原样送到串口。这正好满足了MQTT库对网络层send和recv接口的需求：send就是串口发送，recv就是从我们DMA循环缓冲区里读取TCP数据。

实操心得：AT指令的稳定性AT指令执行需要时间，尤其是连接Wi-Fi和TCP。指令发送后必须等待足够长的超时时间，并严格解析响应。连续发送指令时，中间最好加入HAL_Delay(100)左右的短延时，给模块处理时间。另外，每次上电或重启后，建议先发送AT测试，再发送ATE0关闭回显，避免回显数据干扰响应解析。

5. MQTT客户端库的移植与适配

5.1 库文件引入与平台接口实现

将选定的stm32_mqtt库的源文件（.c和.h）添加到你的工程中。这类库通常核心文件不多，比如mqtt.c、mqtt_packet.c等。查看库的文档或头文件，找到它依赖的平台接口，一般需要你实现以下几个函数：

网络读函数：int mqtt_network_read(void* network, unsigned char* buffer, int len, int timeout_ms)
网络写函数：int mqtt_network_write(void* network, const unsigned char* buffer, int len, int timeout_ms)
获取时间戳函数：uint32_t mqtt_get_timestamp(void)（用于计算超时和心跳）

我们的适配工作主要就是实现这三个函数，让MQTT库能通过ESP8266的透传串口进行网络通信。

网络写函数实现：这非常简单，因为我们已经处于透传模式。

int mqtt_network_write(void* network, const unsigned char* buffer, int len, int timeout_ms) { // network参数可能是一个包含串口句柄的结构体，这里简化处理 HAL_UART_Transmit(&huart2, (uint8_t*)buffer, len, timeout_ms); return len; // 假设总是成功发送所有数据 }

网络读函数实现：这需要从我们之前为ESP8266建立的DMA循环缓冲区中读取TCP数据。这里需要一个环形缓冲区（Ring Buffer）来作为应用层和中断接收层之间的缓存。

在串口空闲中断处理函数esp8266_data_handler中，不再直接解析AT指令（因为已进入透传模式），而是将接收到的数据esp8266_rx_buffer[0:len-1]写入一个环形缓冲区tcp_ring_buffer。
在网络读函数中，从tcp_ring_buffer中读取指定长度的数据。

// 简单的环形缓冲区实现（需考虑线程安全，如果用了RTOS需加互斥锁） static uint8_t tcp_ring_buf[2048]; static uint16_t rb_head = 0, rb_tail = 0, rb_size = 0; // 在esp8266_data_handler中，透传模式下将数据写入环形缓冲区 if(g_esp8266_transparent_mode) { for(int i=0; i<len; i++) { tcp_ring_buf[rb_head] = esp8266_rx_buffer[i]; rb_head = (rb_head + 1) % 2048; if(rb_size < 2048) rb_size++; // 如果缓冲区满了，可以覆盖旧数据或丢弃新数据，根据业务决定 } } int mqtt_network_read(void* network, unsigned char* buffer, int len, int timeout_ms) { uint32_t start = HAL_GetTick(); int bytes_read = 0; while(bytes_read < len) { if(rb_size > 0) { // 有数据可读 buffer[bytes_read] = tcp_ring_buf[rb_tail]; rb_tail = (rb_tail + 1) % 2048; rb_size--; bytes_read++; } else { // 无数据，检查是否超时 if((HAL_GetTick() - start) >= timeout_ms) { break; // 读取超时 } // 可以短暂延时，或进入低功耗状态 // HAL_Delay(1); } } return bytes_read; // 返回实际读取的字节数 }

获取时间戳函数：直接返回HAL库的Tick值即可。

uint32_t mqtt_get_timestamp(void) { return HAL_GetTick(); }

5.2 MQTT客户端初始化与连接

实现好平台接口后，就可以初始化MQTT客户端了。通常流程如下：

#include "mqtt.h" // MQTT库头文件 mqtt_client_t client; uint8_t send_buf[512], read_buf[512]; // MQTT库内部使用的发送和接收缓冲区 // 1. 初始化客户端 mqtt_init(&client, send_buf, sizeof(send_buf), read_buf, sizeof(read_buf)); // 2. 设置回调函数（用于处理订阅消息） mqtt_set_callback(&client, mqtt_message_callback); // 3. 连接MQTT服务器 const char* client_id = "STM32_Device_01"; const char* username = NULL; // 根据服务器要求填写 const char* password = NULL; // 根据服务器要求填写 uint16_t keep_alive = 60; // 心跳间隔，秒 int ret = mqtt_connect(&client, "mqtt.bemfa.com", 9501, client_id, username, password, keep_alive, 0); if(ret != MQTT_CONNECTION_ACCEPTED) { printf("MQTT连接失败，错误码: %d\r\n", ret); // 处理连接失败 }

连接成功后，MQTT库会自动维护一个心跳线程（通常需要你在主循环中定期调用mqtt_yield(&client)来驱动），以保持TCP连接活跃。

6. 应用层整合：数据发布与指令订阅

6.1 定时发布传感器数据

假设我们有一个温度传感器，通过ADC读取。我们可以在主循环或一个定时器中断中，定期采集温度并发布到MQTT主题。

void publish_sensor_data(void) { float temperature = read_temperature(); // 读取温度的函数 char topic[] = "sensor/device01/temp"; char payload[32]; snprintf(payload, sizeof(payload), "%.2f", temperature); // QoS 0，不保留消息 int pub_ret = mqtt_publish(&client, topic, payload, strlen(payload), MQTT_QOS0, 0); if(pub_ret != MQTT_SUCCESS) { printf("发布失败: %d\r\n", pub_ret); // 可以考虑触发重连逻辑 } } // 在主循环中，每5秒发布一次 while(1) { static uint32_t last_pub_time = 0; if(HAL_GetTick() - last_pub_time > 5000) { publish_sensor_data(); last_pub_time = HAL_GetTick(); } // 必须定期调用yield，让MQTT库处理接收和心跳 mqtt_yield(&client, 100); // 超时100ms // 其他任务... }

6.2 订阅主题与处理下行指令

物联网设备不仅要上报数据，还要能接收控制指令。例如，订阅一个控制主题来接收开关命令。

// 首先，在连接成功后订阅主题 char sub_topic[] = "control/device01/switch"; int sub_ret = mqtt_subscribe(&client, sub_topic, MQTT_QOS1); if(sub_ret != MQTT_SUCCESS) { printf("订阅失败: %d\r\n", sub_ret); } // 然后，实现消息回调函数 void mqtt_message_callback(mqtt_client_t* client, const char* topic, const char* payload, int payload_len) { printf("收到消息，主题: [%s], 内容: %.*s\r\n", topic, payload_len, payload); if(strcmp(topic, "control/device01/switch") == 0) { if(payload_len == 1 && payload[0] == '1') { turn_on_relay(); // 打开继电器 } else if(payload_len == 1 && payload[0] == '0') { turn_off_relay(); // 关闭继电器 } } }

在mqtt_yield函数内部，当有消息到达时，会自动调用这个回调函数。

7. 稳定性优化与常见问题排查

7.1 网络异常处理与自动重连

在实际环境中，网络断开、服务器重启是常态。一个健壮的系统必须具备自动重连能力。

心跳与保活：MQTT的Keep Alive机制是基础。如果客户端在1.5倍Keep Alive时间内没有与服务器通信，服务器会认为连接已死，断开它。客户端如果在Keep Alive时间内没有发送任何报文，必须发送一个PINGREQ心跳请求。我们使用的MQTT库通常会自动处理心跳。确保mqtt_yield被频繁调用（比如在主循环中），库才能及时发送心跳和检测超时。

断线检测与重连策略：

检测断线：MQTT库的mqtt_yield函数返回值可能指示连接丢失。更直接的方法是，如果长时间（比如超过2倍Keep Alive时间）没有成功发布或收到任何MQTT报文，可以认为连接异常。也可以在TCP层检测，如果ESP8266的透传串口长时间没有收到任何数据（可能是TCP连接已断），可以发送一个AT指令测试，如果没有响应，说明连接可能有问题。

重连流程：一旦检测到断线，需要执行完整的重连流程：

void mqtt_reconnect(void) { mqtt_disconnect(&client); // 清理MQTT客户端状态 // 1. 退出ESP8266透传模式 HAL_UART_Transmit(&huart2, (uint8_t*)"+++", 3, 200); // 注意：退出透传需要先发送"+++"，且不能带\r\n HAL_Delay(1000); // 等待模块响应“OK” // 发送AT确认退出 ESP8266_SendCmdAndWaitResp("AT", "OK", 1000); // 2. 关闭之前的TCP连接（如果存在） ESP8266_SendCmdAndWaitResp("AT+CIPCLOSE", "OK", 3000); // 3. 重新连接TCP服务器并进入透传 if(ESP8266_ConnectTCPServer(MQTT_SERVER, MQTT_PORT) == ESP8266_OK) { // 4. 重新连接MQTT服务器 int ret = mqtt_connect(&client, ...); if(ret == MQTT_CONNECTION_ACCEPTED) { // 5. 重新订阅主题 mqtt_subscribe(&client, ...); printf("重连成功！\r\n"); } } }

注意：发送"+++"退出透传模式时，必须确保在发送前和发送后各有至少1秒的静默时间（即不要发送其他数据），这是ESP8266 AT固件的规定。

7.2 常见问题与排查技巧实录

ESP8266无响应或响应乱码
- 检查电源：确保是稳定的3.3V供电，电流足够（峰值可能超过200mA），最好用示波器看电源纹波。可以在VCC和GND之间并联一个100uF和0.1uF的电容。
- 检查波特率：确认STM32串口波特率与ESP8266固件波特率一致（通常是115200）。
- 检查接线：TX/RX是否交叉连接，CH_PD是否拉高，GPIO0是否悬空（运行模式）。
- 检查固件：用USB转TTL直接连接电脑，测试基本AT指令（AT、AT+GMR）是否正常。
连接Wi-Fi总是失败
- SSID/密码错误：确认没有多余空格，特殊字符是否需要转义。
- 信号强度：ESP8266的Wi-Fi接收能力一般，确保信号足够强（可以用手机测一下）。
- 路由器设置：有些路由器可能禁止了802.11b/g模式，或者有MAC地址过滤。尝试用手机热点测试。
- 指令顺序和延时：AT+CWMODE设置后最好延时几百毫秒再执行AT+CWJAP。
TCP连接失败或MQTT连接被拒绝
- 服务器地址和端口：确认无误。有些公共服务器需要注册获取密钥。
- 网络可达性：确保ESP8266能正常访问互联网（可以尝试AT+PING=\"www.baidu.com\"）。
- 防火墙：本地网络或服务器端口是否开放。
- MQTT协议版本或参数：检查客户端ID是否合法，用户名密码是否正确，Keep Alive时间是否合理。
数据收发不稳定，偶尔丢数据
- 串口缓冲区溢出：检查DMA接收缓冲区是否够大，应用层环形缓冲区是否够大，处理速度是否跟不上接收速度。
- MQTT库缓冲区不足：增大send_buf和read_buf的大小，特别是要发布的消息较长时。
- 网络质量差：考虑使用MQTT的QoS 1等级（需要确认），虽然会增加流量，但能保证消息至少送达一次。同时优化重连逻辑。
- 中断优先级：如果使用了RTOS或其他高优先级中断，确保串口中断的优先级设置合理，避免数据接收被长时间打断。
长时间运行后死机
- 内存泄漏：检查MQTT库和网络层代码，是否有动态内存分配未释放。嵌入式环境最好使用静态内存池。
- 看门狗：启用STM32的独立看门狗（IWDG），在主循环中定期喂狗。如果程序跑飞或阻塞，看门狗会复位系统。
- 堆栈溢出：如果使用RTOS，合理设置任务的堆栈大小，并留意库函数内部的局部变量是否过大。