适用范围与准备

适用于自己的 HTTP 接口接收整个文本或二进制请求体:本地文件正确,但通过 curl 提交后换行或字节内容变化。先确认接口需要原始正文,而不是 multipart 文件表单、JSON 对象或 URL 编码字段。

先区分原因

用 --data @文件读取时,curl 会去掉回车、换行及空字节;--data-binary @文件保留原始字节。仅给 --data 加一个 Content-Type 头,并不会改变它读取文件的方式;--data-binary 也不会自动判断文件的 MIME 类型。

按顺序操作

  1. 保留原文件,在单独目录制作不含密码和订阅链接的短测试样本,写两行文字并记录保存编码。检查接口文档是否要求整个请求体就是文件内容;不确定时先向接口维护者确认。
  2. 核对实际命令是 --data、--data-raw 还是 --data-binary。下面示例用 --data-binary 读取 sample.txt;@ 表示从文件读取,路径须指向这个非敏感样本。
  3. 只向允许测试提交的端点执行一次。Content-Type 取接口要求;示例的 application/octet-stream 适用于接收任意原始字节的测试服务,不是所有文本或 JSON API 的通用值。
  4. 让测试接收端比较收到的字节与原文件,包括换行和编码;可用双方的文件哈希核对。不要只通过网页显示“看起来相同”判断,因为显示层也可能折叠空白。
  5. 若字节一致但接口仍拒绝,继续检查字段结构、媒体类型和认证;若原文件已经被编辑器改写,--data-binary 也不能恢复旧内容。保持一个文件对应一个参数,避免多个 data 参数连接出意外正文。
PowerShell;macOS/Linux 改为 curl。POST 会提交数据;仅用于获准的测试接收端。
curl.exe --disable --fail --connect-timeout 10 --max-time 30 --header "Content-Type: application/octet-stream" --data-binary "@sample.txt" "https://example.com/test-body"
写法需要留意
--data @sample.txt读取时会去掉回车、换行、空字节
--data-binary @sample.txt原样读取,但媒体类型需另核对
--data-raw @sample.txt@ 不表示读文件,发送的是字面文本
--form file=@./sample.txtmultipart 表单,与整个原始正文不同

怎样确认有效

接收端记录的正文与样本逐字节一致,且接口按要求处理成功。HTTP 200 或文件大小相同都不能单独证明内容未被改写;正式数据尚未提交时就注明仅完成样本验证。

无效时恢复与下一步

恢复原脚本前保存本次命令对照,删除测试样本按本地需要处理。不要把真实订阅、令牌或用户文件发到公共回显网站来证明换行问题。