curl 手拼 multipart 边界写错 服务端一直报 400 怎么换成 CURLFile

对接的发票平台要求 multipart 上传两张图,自研的 Curl 封装手拼了 body。对方一直回 HTTP 400,本地用 Postman 传同样的字段却能过。

拼出来的 body 是 --$boundary 加 Content-Disposition 头,再跟 Content-Type,然后直接接文件内容,中间少了一个空行。文件开头两个字节被当成头部的一部分,对方解析器读到非法 header,直接 400。

还有一处更要命:结尾写的是 --$boundary--,没带后面的 CRLF。curl 不会替你补,Content-Length 按字符串长度算,比标准少 2 字节,部分网关先拒。

排查靠 tcpdump -A -s 0 'tcp port 443' 存一份,再把 Postman 的请求也抓一份,两边 diff,差异就是那三处 CRLF。中间还试过把 Content-Type 里的 boundary 加引号,结果更糟,RFC 里 boundary 不需要引号,加了之后某些解析器匹配不上。

最后不手拼了,用 CURLFile。数组里放 new CURLFile($path, 'image/jpeg', 'a.jpg'),CURLOPT_POSTFIELDS 直接给数组,边界、长度、结尾 CRLF 全由 libcurl 生成,PHP 8.1 加 curl 7.81 一次通过。

判别手拼对不对有个土办法:$_FILES 为空而 $_POST 有值,基本是边界或 CRLF 错了;两者都空,才去查 Content-Length 和网关限制。

手拼 multipart 唯一值得留的场景是复现别人抓包里的畸形请求,业务代码里没有理由这么写。

$fields = [
    'invoice_no' => $no,
    'file' => new CURLFile($path, 'image/jpeg', 'a.jpg'),
];
curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $fields,   // 不要先编码
]);

您可以还会对下面的文章感兴趣: