HTTP.jl上传文件必须用HTTP.Multipart显式构建，不能直接传raw body；需传IO对象或HTTP.MultipartPart（带filename和content_type），避免400/415错误及内存溢出。
HTTP.jl 上传文件必须用 Multipart，不能直接传 raw body
HTTP.jl 默认不支持像 curl -F 那样自动构造表单数据，直接把文件字节塞进 body 会触发 400 或 415 错误——服务端收不到标准的 multipart/form-data 边界和字段结构。
正确做法是用 HTTP.Multipart 显式构建多部分体，它会自动生成边界、头字段和编码逻辑。
-
HTTP.Multipart接收一个Vector{Pair{String, Any}}，键是表单字段名，值可以是String、Vector{UInt8}或IO对象（如打开的文件） - 如果值是文件路径字符串（比如
"./report.pdf"），HTTP.jl 不会自动读取——必须显式用open(...)或read(...) - 字段顺序会影响服务端解析（尤其多个同名字段时），建议按 API 文档要求排列
上传本地文件：用 open() 包裹文件句柄，别用 read() 全加载到内存
对大文件（>10MB），用 read("file.pdf") 会一次性把整个文件载入内存，容易 OOM；而 open("file.pdf", "r") 返回流式 IO，HTTP.jl 内部会分块读取并写入请求体，内存占用稳定在几 KB 级别。
using HTTP, JSON
<p>file_io = open("data.csv", "r")
payload = HTTP.Multipart([
"description" => "upload via Julia",
"file" => file_io # ← 这里传 IO 对象，不是字符串路径
])</p><p>response = HTTP.post(
"<a href="https://www.php.cn/link/dc076eb055ef5f8a60a41b6195e9f329">https://www.php.cn/link/dc076eb055ef5f8a60a41b6195e9f329</a>",
headers = ["Content-Type" => "multipart/form-data"],
body = payload
)</p><p>close(file_io) # 记得关闭，否则文件句柄泄漏</p>上传内存中数据（如 DataFrame CSV 字节）：用 Vector{UInt8} + 指定 filename
如果你已有数据（比如 DataFrame 转成 CSV 字节），但没落地为文件，不能直接传 String 或 IOBuffer——HTTP.jl 的 Multipart 对 Vector{UInt8} 会默认当二进制字段，不带 filename 和 Content-Type。必须用 HTTP.FormData 或手动构造 HTTP.MultipartPart。
- 推荐用
HTTP.MultipartPart：可精确控制name、filename、content_type -
filename是关键——没有它，服务端通常当作普通文本字段而非文件字段 -
content_type建议显式设（如"text/csv"），否则默认"application/octet-stream"
using HTTP, DataFrames, CSV
<p>df = DataFrame(a=[1,2], b=["x","y"])
csv_bytes = CSV.write(IOBuffer(), df; header=true); seekstart(csv_bytes)
body_bytes = read(csv_bytes, Vector{UInt8})</p><p>part = HTTP.MultipartPart(
name = "file",
filename = "data.csv",
content_type = "text/csv",
data = body_bytes
)</p><p>payload = HTTP.Multipart([part])
response = HTTP.post("<a href="https://www.php.cn/link/dc076eb055ef5f8a60a41b6195e9f329">https://www.php.cn/link/dc076eb055ef5f8a60a41b6195e9f329</a>", body = payload)</p>常见错误：400 Bad Request / 415 Unsupported Media Type / 空文件上传
这三个错误基本都指向 multipart 构造失败。最常踩的坑不是代码语法，而是语义细节：
- 漏掉
filename参数 → 服务端收到的是字段值，不是文件字段 → 返回 400 - 手动设了
headers = ["Content-Type" => "multipart/form-data"]→ 覆盖了 HTTP.jl 自动生成的带 boundary 的头 → 415 - 传了
open("x.txt", "w")（写模式）→ IO 句柄不可读 → 上传空内容 → 服务端收空文件 - 用
HTTP.get()或HTTP.put()发 multipart → 协议不匹配 → 405 或静默失败
HTTP.jl 的 multipart 实现轻量但严格，边界、换行、编码全靠内部逻辑生成，任何手动拼接或头覆盖都会破坏协议合规性。真正要调试时，用 HTTP.DebugRequest() 或抓包看原始请求体，比猜更可靠。
