如何在Bash Curl中正确使用--data-binary传递多参数并获成功响应？

咱们先一步步拆解你的问题，看看PHP代码和Bash命令的差异，以及如何用--data-binary实现正确请求：

1. 原PHP代码的核心逻辑 #

你的PHP代码本质是发送**multipart/form-data类型的POST请求**：

• 用CurlFile实现文件上传，同时携带jsondata参数
• 虽然你手动设置了两个冲突的Content-Type头（multipart/form-data和application/x-www-form-urlencoded），但PHP的Curl在处理包含CurlFile的数组时，会自动覆盖这个错误设置，生成正确的multipart/form-data请求头，所以代码能正常工作。
• 另外，CURLOPT_BINARYTRANSFER在PHP 5.1.3+已经被废弃，它的作用是让curl返回原始二进制响应数据，并不影响请求的构造。

2. 你最初的Bash命令为什么失败？ #

你用--data-binary的命令有两个致命问题：

• 同时设置两个Content-Type头，违反HTTP规范，服务器无法正确识别请求类型
• --data-binary是用于发送application/x-www-form-urlencoded或原始二进制数据的，它无法构造multipart/form-data请求的复杂结构（比如边界分隔符、文件字段的元信息），所以服务器解析不了你的文件和参数，返回error。

3. 为什么-F参数能正常工作？ #

-F（即--form）是curl专门为multipart/form-data请求设计的参数，它会自动：

• 生成随机的边界分隔符
• 构造每个字段的元信息（比如文件的filename和Content-Type）
• 设置正确的Content-Type请求头
  这和你PHP代码的行为完全一致，所以服务器能正确解析，返回success。

4. 如何用--data-binary实现正确请求？ #

如果你一定要用--data-binary，就必须手动构造整个multipart/form-data的请求体，包括边界分隔符、每个字段的头信息和内容。示例命令如下：

# 定义一个随机的边界字符串，避免和请求内容冲突
BOUNDARY="MyUniqueBoundary_123456789"

# 构造完整的multipart请求体并发送
curl -i -X POST \
  -H "Content-Type: multipart/form-data; boundary=$BOUNDARY" \
  --data-binary "--$BOUNDARY\r\nContent-Disposition: form-data; name=\"filename\"; filename=\"test.txt\"\r\nContent-Type: text/plain\r\n\r\n$(< /root/test.txt)\r\n" \
  --data-binary "--$BOUNDARY\r\nContent-Disposition: form-data; name=\"jsondata\"\r\n\r\n{\"fileName\":\"test\",\"id\":\"xxx\",\"backlink\":\"https://example.com/hello\"}\r\n" \
  --data-binary "--$BOUNDARY--\r\n" \
  https://example.com/convert2PDF

关键注意点： #

• 边界字符串要足够独特，避免和文件内容或参数内容重复
• 每个字段的格式必须严格遵循multipart/form-data规范：
  1. 以--边界字符串开头
  2. 紧接着是字段的Content-Disposition头（文件字段要额外指定filename和Content-Type）
  3. 用空行（\r\n\r\n）分隔头信息和字段内容
  4. 最后以--边界字符串--结束整个请求体
• 如果上传的是二进制文件，不要用cat，建议用$(< /path/to/file)读取，避免编码转换问题

总结 #

其实强烈推荐继续使用-F参数，它简洁、不易出错，完全匹配你PHP代码的请求逻辑。如果非要用--data-binary，就必须手动构造完整的multipart请求体，这会增加维护成本，容易因为格式错误导致请求失败。

内容的提问来源于stack exchange，提问作者兰秀菊