ESP-32 笔记（4）https 进阶：事件驱动与流式下载实战

1. 事件驱动模型解析

在ESP32开发中，esp_http_client库的事件驱动机制就像一位尽职的快递员，每当有包裹状态更新就会主动通知你。这个机制的核心是esp_http_client_event_t结构体，它包含了7种不同的事件类型：

• HTTP_EVENT_ON_CONNECTED：相当于快递员告诉你"我已经到快递站了"
• HTTP_EVENT_ON_DATA：最重要的数据到达事件，就像快递员把包裹递到你手上
• HTTP_EVENT_ON_FINISH：整个派送完成的确认通知

实际开发中最关键的是处理HTTP_EVENT_ON_DATA事件。这里有个坑我踩过：当处理大文件时，直接在每个数据包到来时打开/关闭文件会导致性能急剧下降。正确的做法是在连接建立时打开文件，在结束时关闭：

FILE *download_file = NULL; esp_err_t http_event_handler(esp_http_client_event_t *evt) { switch(evt->event_id) { case HTTP_EVENT_ON_CONNECTED: download_file = fopen("/spiffs/large_file.bin", "wb"); break; case HTTP_EVENT_ON_DATA: if (download_file) { fwrite(evt->data, 1, evt->data_len, download_file); } break; case HTTP_EVENT_ON_FINISH: if (download_file) { fclose(download_file); download_file = NULL; } break; } return ESP_OK; }

2. 流式下载实战技巧

流式下载就像用吸管喝饮料，不需要等整杯喝完才能解渴。ESP32的内存有限（通常只有几百KB），处理大文件时必须使用流式方式。这里分享几个关键参数配置：

esp_http_client_config_t config = { .url = "http://example.com/large_file.zip", .event_handler = http_event_handler, .buffer_size = 2048, // 适当增大缓冲区提高性能 .buffer_size_tx = 512, // 发送缓冲区可以小些 .timeout_ms = 10000 // 超时设置要合理 };

实测发现，当下载超过1MB的文件时，使用默认配置容易导致内存不足。我建议：

1. 将buffer_size设置为2KB-4KB之间
2. 启用is_async模式避免阻塞主线程
3. 添加进度回调函数：

void progress_callback(size_t received, size_t total) { int percent = (int)((float)received / total * 100); printf("下载进度: %d%%\r", percent); } // 在HTTP_EVENT_ON_DATA事件中调用 case HTTP_EVENT_ON_DATA: if (evt->user_data) { size_t *total = (size_t*)evt->user_data; *total += evt->data_len; progress_callback(*total, esp_http_client_get_content_length(evt->client)); } break;

3. 网络中断处理方案

在实际项目中，WiFi信号不稳定是常态。我总结了一套重连机制，包含三个关键点：

指数退避算法：重试间隔应该逐渐增加，避免网络刚恢复时的拥塞

int retry_count = 0; const int max_retry = 5; esp_err_t err = esp_http_client_perform(client); while (err != ESP_OK && retry_count < max_retry) { int delay_ms = (1 << retry_count) * 1000; // 1,2,4,8,16秒 vTaskDelay(delay_ms / portTICK_PERIOD_MS); // 重置读取位置 esp_http_client_set_header(client, "Range", "bytes=0-"); err = esp_http_client_perform(client); retry_count++; }

断点续传：利用HTTP的Range头部实现

// 获取已下载文件大小 size_t downloaded_size = get_file_size("/spiffs/partial_file"); // 设置Range头部 char range_header[32]; snprintf(range_header, sizeof(range_header), "bytes=%zu-", downloaded_size); esp_http_client_set_header(client, "Range", range_header); // 以追加模式打开文件 download_file = fopen("/spiffs/partial_file", "ab");

状态保存：在SPIFFS中保存下载元数据

typedef struct { char url[256]; size_t downloaded; time_t last_modified; } download_state_t; // 中断时保存状态 download_state_t state = { .downloaded = ftell(download_file), .last_modified = time(NULL) }; write_state_to_file("/spiffs/download.state", &state);

4. 性能优化实践

经过多次测试，我发现以下优化手段能显著提升下载速度：

1. TCP窗口调整：在menuconfig中增大TCP窗口大小

   Component config → LWIP → TCP → TCP window size (bytes) → 8192

2. DNS缓存：减少DNS查询时间

   esp_netif_set_dns_info(ESP_IF_WIFI_STA, ESP_NETIF_DNS_MAIN, &dns);

3. 选择性接收：对于不需要的HTTP头可以跳过

   case HTTP_EVENT_ON_HEADER: // 只处理Content-Length头 if (strcmp(evt->header_key, "Content-Length") == 0) { total_size = atoi(evt->header_value); } break;

4. 内存池优化：使用静态分配代替动态内存

   static uint8_t download_buffer[4096]; esp_http_client_set_post_field(client, (char*)download_buffer, sizeof(download_buffer));

实测数据显示，经过优化后，1MB文件的下载时间从原来的12秒降低到8秒左右，内存使用峰值减少约30%。特别是在信号较弱的场景下，断点续传功能可以节省50%以上的重复流量。