发送 multipart/form-data 的核心难点在于必须严格手动生成符合 rfc 7578 的结构化字节流：需唯一生成 boundary、精准构造每部分头部与空行、正确添加结尾标记，且发送时须按完整字节流处理（避免 \0 截断），并确保所有 crlf 换行符和 boundary 字符串逐字节一致。
发送 multipart/form-data 的核心难点在哪
直接用 send() 发 raw bytes 不行，因为 multipart 本质是带边界标记（boundary）的结构化文本协议，必须手动生成符合 RFC 7578 的格式——不是拼接字符串那么简单，边界必须唯一、不能出现在正文里，且每部分的头字段（如 Content-Disposition）和空行位置必须严格对齐。
手动构造 multipart body 的关键步骤
用 C++ 构造 multipart body 时，别依赖第三方库（比如 libcurl 内部处理），自己写要控制三件事：boundary 生成、part 头部格式、结尾边界标记。常见错误是漏掉最后的 --boundary--\r\n 或在 part body 后多加空行。
- 用随机字符（如 UUID 片段）生成 boundary，避免与实际数据冲突，例如
"----boundary_1a2b3c4d" - 每个 part 以
--{boundary}\r\n开头，后跟Content-Disposition: form-data; name="field_name"; filename="file.txt"\r\n（有文件时加filename，无则省略） - 紧接着一个空行
\r\n，再写 part body（二进制内容需原样写入，不转义） - 所有 part 结束后，写
--{boundary}--\r\n表示结束
socket 发送时的编码与长度陷阱
multipart 是文本协议，但可能含二进制文件，所以整个 body 必须按字节流发送，不能用 std::string 隐式转换（尤其含
multipart 是文本协议，但可能含二进制文件，所以整个 body 必须按字节流发送，不能用 std::string 隐式转换（尤其含 \0 时会截断）。常见错误是用 send(sock, str.c_str(), ...) ——c_str() 遇 \0 就停，导致文件被砍掉。
send(sock, str.c_str(), ...) ——c_str() 遇 multipart 是文本协议，但可能含二进制文件，所以整个 body 必须按字节流发送，不能用 std::string 隐式转换（尤其含 \0 时会截断）。常见错误是用 send(sock, str.c_str(), ...) ——c_str() 遇 \0 就停，导致文件被砍掉。
- 用
std::vector<uint8_t></uint8_t>或std::string_view管理完整字节流，确保长度传的是data.size()而非strlen(c_str()) - HTTP 请求头里必须显式声明
Content-Type: multipart/form-data; boundary=----boundary_1a2b3c4d - 发送顺序必须是：请求行 → 请求头 → 空行 → multipart body；中间任何一步少 \r\n 都会让服务器解析失败
调试时最常卡住的地方
服务器返回 400 或静默丢包，大概率是 boundary 不匹配或换行符不对。Windows 和 Linux 对 \r\n 的敏感度不同，但 HTTP 协议强制要求 CRLF，用 \n 替代 \r\n 在多数服务端会直接拒绝。
- 用
tcpdump或 Wireshark 抓包，确认发出的字节流里 boundary 字符串前后、结尾是否完全一致 - 检查每个
\r\n是否真的两个字节（0x0d 0x0a），别用编辑器“自动换行”功能污染内容 - 如果发的是图片等二进制，先用
hexdump -C对比本地文件和发出去的 body 片段，确认没被意外修改
边界字符串一旦定下，header 里的 boundary=、body 中的 --{boundary}、结尾的 --{boundary}-- 必须逐字节相同，差一个字符或大小写都不行。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
