ESP32（Arduino C++）网页上传大.bin文件缓冲区读取异常问题

问题本质 #

你遇到的1436字节限制，是ESP32 WebServer（含WifiManager依赖的WebServer组件）内置HTTPUpload缓冲区的默认大小——这个值对应以太网MTU的常见规格，文件上传时会按这个块大小分批次读取请求体。如果代码没有处理分块累加逻辑，后续块的内容会直接覆盖前一块的缓冲区，最终只能保留部分数据。

HTTPUpload缓冲区的加载时机与机制 #

WebServer处理文件上传的流程如下：

• 客户端发起上传请求后，WebServer会逐块读取HTTP请求的body部分，每块固定为1436字节（默认值）
• 每当一块数据被读入缓冲区，或上传结束/中断时，会触发你注册的上传处理函数（handleUpdatingLora()）
• HTTPUpload对象的status字段标记当前阶段：
  • UPLOAD_FILE_START：上传开始，可获取文件总大小、文件名等元信息
  • UPLOAD_FILE_WRITE：缓冲区已填满一块数据，buf指向当前块内容，currentSize为当前块字节数
  • UPLOAD_FILE_END：上传完成，所有块传输完毕
  • UPLOAD_FILE_ABORTED：上传中断

你的问题根源在于，未在UPLOAD_FILE_WRITE阶段持续累加每块数据，仅读取了第一块内容就停止处理，或错误覆盖了已存储的数据。

修复方案 #

1. 实现分块数据累加逻辑 #

需要开辟独立存储区域（RAM缓冲区或外部存储），在每次UPLOAD_FILE_WRITE回调时，将当前块数据追加到存储区域，直到上传完成。

示例核心代码：

// 全局变量用于存储上传数据（大文件建议用SPIFFS/SD卡替代RAM）
uint8_t* uploadStorage = nullptr;
size_t totalFileSize = 0;
size_t uploadedBytes = 0;

void handleUpdatingLora() {
  HTTPUpload& upload = server.upload();
  
  if (upload.status == UPLOAD_FILE_START) {
    // 初始化存储：根据文件总大小分配内存
    totalFileSize = upload.contentLength;
    uploadStorage = (uint8_t*)malloc(totalFileSize);
    uploadedBytes = 0;
    
    // 调试网页输出初始化信息
    String debugHtml = "<html><body>上传开始，文件大小：" + String(totalFileSize) + "字节<br>";
    server.send(200, "text/html", debugHtml);
  } else if (upload.status == UPLOAD_FILE_WRITE) {
    // 累加当前块数据到自定义缓冲区
    memcpy(uploadStorage + uploadedBytes, upload.buf, upload.currentSize);
    uploadedBytes += upload.currentSize;
    
    // 更新调试网页显示进度
    String debugHtml = "<html><body>上传中...已接收：" + String(uploadedBytes) + "/" + String(totalFileSize) + "字节<br>";
    server.send(200, "text/html", debugHtml);
  } else if (upload.status == UPLOAD_FILE_END) {
    // 上传完成，uploadStorage中是完整的.bin文件数据
    // 调试网页验证数据完整性，例：输出前32字节十六进制
    String debugHtml = "<html><body>上传完成！总接收：" + String(uploadedBytes) + "字节<br>";
    debugHtml += "前32字节：";
    for (int i=0; i<32 && i<uploadedBytes; i++) {
      debugHtml += String(uploadStorage[i], HEX) + " ";
    }
    debugHtml += "</body></html>";
    server.send(200, "text/html", debugHtml);
    
    // 执行UART发送逻辑（此处省略，根据你的需求实现）
    
    // 释放内存
    free(uploadStorage);
    uploadStorage = nullptr;
  }
}

2. 大文件优化建议 #

如果.bin文件超过ESP32 RAM容量（如大于500KB），不要用RAM缓冲区存储，直接将每块数据写入SPIFFS或SD卡，上传完成后再从存储设备读取并通过UART发送，避免内存溢出。

关键注意事项 #

• 动态分配内存时，必须检查malloc返回值是否为nullptr，避免内存分配失败导致崩溃
• WebServer的HTTPUpload缓冲区大小固定，无法通过API修改，必须通过分块累加逻辑处理大文件
• 调试网页可加入更多细节（如每块字节数、当前块部分内容），帮助确认数据是否被正确捕获

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