HTTP文件上传本质是构造符合RFC 7578的multipart/form-data请求体，核心难点在于boundary生成、Content-Disposition头、二进制处理及\r\n严格匹配；推荐用libcurl实现，手动socket仅适用于学习。
HTTP文件上传的本质是构造 multipart/form-data 请求体
不是调用某个“上传函数”就能搞定，C++标准库不提供现成的HTTP客户端，必须手动拼接符合 RFC 7578 的 multipart/form-data 请求体，并通过 socket 或第三方库（如 libcurl）发送。核心难点不在 C++ 语法，而在正确生成 boundary、Content-Disposition 头、二进制边界处理和换行符（\r\n）的严格匹配。
常见错误现象：400 Bad Request 或服务端解析出空文件，往往是因为 boundary 不一致、缺少结尾 --boundary--\r\n、或二进制文件内容被文本模式截断（尤其 Windows 下 fopen 未加 "rb"）。
- boundary 必须全局唯一，建议用 UUID 或时间戳+随机数生成，避免与文件内容冲突
- 每个 part 之间用
--{boundary}\r\n分隔，结尾用--{boundary}--\r\n - 文件字段的
Content-Disposition必须含filename="xxx"，否则服务端视为普通表单字段 - 文件内容必须原样写入（
std::ofstream::binary或fread+fwrite），不能经过任何文本编码转换
用 libcurl 实现最简可行上传（推荐）
自己写 socket + HTTP 解析极易出错，libcurl 是事实标准。它内置 multipart 构建逻辑，只需设置几个关键选项，不用手搓 boundary 和头字段。
典型流程：初始化 curl 句柄 → 添加 CURLOPT_HTTPPOST 指向 curl_httppost 链表 → 设置文件路径、字段名、可选 MIME 类型 → 执行。
CURLOPT_NAME
注意：CURLOPT_CONTENTS 是文件路径（libcurl 自动以二进制打开），不是内存地址；若需从内存上传，得用 CURLOPT_READFUNCTION + CURLOPT_READDATA 配合自定义回调。
不依赖第三方库？用 std::filesystem + socket 手动发请求
仅适用于学习或极简嵌入场景，生产环境不建议。关键点在于：HTTP/1.1 要求 Content-Length 必须精确，而 multipart 总长度取决于文件大小 + boundary + 头字段长度，必须预先计算或用 chunked 编码（更复杂）。
步骤：
- 用
std::filesystem::file_size()获取文件字节长度 - 生成随机 boundary，如
"----WebKitFormBoundary" + random_string(16) - 计算整个请求体长度：各 part 头 + 文件内容 + 结尾 boundary
- 构造完整请求字符串（含
POST /upload HTTP/1.1、Host、Content-Type: multipart/form-data; boundary=xxx、Content-Length） - 用
socket连接服务器，send()全部数据，recv()读响应
容易踩的坑：Content-Length 少算一个 \r\n 就导致服务端卡住；Windows 上 socket 默认非阻塞或缓冲区太小，大文件要分次 send 并检查返回值；DNS 解析需自己处理（getaddrinfo）。
上传大文件时必须考虑的三个实际问题
10MB 以上文件会暴露底层细节：内存占用、超时、断点续传缺失、服务端限制。这些问题不会在“hello world”例子里出现，但一上线就撞墙。
-
CURLOPT_TIMEOUT和CURLOPT_CONNECTTIMEOUT必须显式设大（如 300 秒），否则默认 30 秒上传中途就失败 - libcurl 默认把整个文件读进内存再发，大文件会爆内存；改用
CURLOPT_READFUNCTION实现流式读取（每次只读 8KB） - 服务端常有
max_file_size（Nginx 的client_max_body_size）或upload_max_filesize（PHP）限制，上传前最好先HEAD查询接口支持的最大尺寸
boundary 的随机性、二进制安全、Content-Length 精确性、超时控制——这四点漏掉任何一个，上传都可能在特定文件或网络环境下静默失败。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
