Arduino带Boundary的HTTP POST上传图片遇异常求技术指导

嘿，我之前也碰到过Arduino和Rails做multipart上传的坑，结合你说的情况，咱们一步步理清楚问题所在：

核心问题分析 #

你提到添加Boundary后请求异常，哪怕简化头部代码仍无法工作，大概率是HTTP请求格式不符合规范——Rails对HTTP请求的格式要求很严格，尤其是multipart/form-data类型的请求，哪怕是换行符、Boundary格式这类细节出错，都会导致服务器解析失败。

常见问题点与修复方案 #

1. 换行符必须用\r\n而非\n #

Arduino的client.println()默认只输出\n，但HTTP协议要求头部的每行必须用\r\n结尾，而且头部和正文之间必须有一个空的\r\n（也就是连续两个换行）。很多时候就是这个细节导致服务器无法识别头部结束，一直处于等待状态。

修正方式：
把client.println()换成client.print()，手动添加\r\n：

// 替换原来的println写法
sprintf(outBuf,"POST %s HTTP/1.1\r\n", page);
client.print(outBuf);
sprintf(outBuf,"Host: %s\r\n", domainBuffer);
client.print(outBuf);

2. Boundary的格式与使用必须严格规范 #

如果要做multipart上传，Boundary的设置要注意这几点：

• Boundary字符串不能包含空格或特殊字符（可以用类似----ArduinoForm12345这种简单格式）
• 必须在Content-Type头部明确指定Boundary
• 每个表单部分的开头是--{Boundary}\r\n，结尾必须是--{Boundary}--\r\n

完整的multipart请求示例代码：

const char* boundary = "----ArduinoFormBoundary123456";
const char* page = "/api/images";
const char* domainBuffer = "your-rails-server.com";

// 假设图片数据存在imageBuffer，长度为imageLen
byte imageBuffer[] = { /* 你的图片字节数据 */ };
int imageLen = sizeof(imageBuffer);

// 计算Content-Length（必须精确，否则Rails会拒绝）
int contentLen = 
  strlen("--") + strlen(boundary) + strlen("\r\n") +
  strlen("Content-Disposition: form-data; name=\"image\"; filename=\"photo.jpg\"\r\n") +
  strlen("Content-Type: image/jpeg\r\n\r\n") +
  imageLen +
  strlen("\r\n--") + strlen(boundary) + strlen("--\r\n");

// 发送头部
client.print("POST ");
client.print(page);
client.print(" HTTP/1.1\r\n");
client.print("Host: ");
client.print(domainBuffer);
client.print("\r\n");
client.print("Content-Type: multipart/form-data; boundary=");
client.print(boundary);
client.print("\r\n");
client.print("Content-Length: ");
client.print(contentLen);
client.print("\r\n");
// 头部结束必须加空行
client.print("\r\n");

// 发送multipart内容
client.print("--");
client.print(boundary);
client.print("\r\n");
client.print("Content-Disposition: form-data; name=\"image\"; filename=\"photo.jpg\"\r\n");
client.print("Content-Type: image/jpeg\r\n\r\n");
// 写入图片二进制数据
client.write(imageBuffer, imageLen);
// 结束multipart
client.print("\r\n--");
client.print(boundary);
client.print("--\r\n");

3. 用串口调试对比请求格式 #

这是最有效的排查方法：把Arduino发送的所有内容通过Serial.print()打印出来，然后和Postman里的Raw请求对比（Postman可以复制Raw请求文本），看两者的换行符、Boundary、Content-Length等是否一致。

比如你可以在每一行client.print()后加一行Serial.print()，这样就能看到发送的内容和Postman的请求哪里不一样。

4. 查看Rails服务器日志 #

打开Rails项目的log/development.log，看看服务器收到的请求是什么样的——如果请求格式错误，日志里会明确显示解析失败的原因（比如ActionDispatch::Http::Parameters::ParseError），这能帮你快速定位问题。

简化代码的问题排查 #

你现在简化的头部代码如果仍无法工作，大概率是缺少头部结束的空行，或者换行符用了\n而非\r\n。比如你需要在所有头部行之后加一行client.print("\r\n");来告诉服务器头部结束了。

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