适用范围与准备
适用于有文档的HTTP上传接口,curl请求发出了但服务端找不到文件字段,或提示multipart格式错误。先用本地测试接口和不含隐私的小文件复现,不把真实订阅、日志或账户文件上传到陌生测试站。
先区分原因
-F/--form会构造multipart/form-data正文,并生成与正文分隔符配套的Content-Type。把别处复制的boundary硬编码进请求头、混用手写正文或字段名,可能导致服务端无法解析。文件字段的名称属于接口约定,不能靠换代理修正。
按顺序操作
- 先读上传接口约定,确认方法、文件字段名、普通文本字段和可接受类型。字段名是file还是upload必须以接口为准,不根据文件扩展名猜。
- 在隔离目录准备一个小的无敏感文本文件;使用-F传文件,普通文本用普通字段或--form-string。@是读取本地文件的指示,不能把含@的用户文本误当路径。
- 去掉从别处粘来的顶层Content-Type和boundary,让curl生成完整multipart请求。每个部分的类型可按文档单独指定,不把整个请求改为application/json。
- 在本人维护的测试接口查看解析出的字段名、文件名和长度。成功后再按真实服务规定操作;不得为排障对生产上传无关文件或重复提交已有附件。
printf "roxi multipart example\n" > sample.txt
curl -sS --max-time 10 --form "upload=@./sample.txt;type=text/plain" --form-string "label=example" --output upload-response.json "http://127.0.0.1:8000/upload"| 位置 | 应保持一致 |
|---|---|
| Content-Type的boundary | 与正文分隔符相同,由curl生成 |
| upload字段名 | 与接口约定相同 |
| 文件内容 | 与本地无敏感样例相同 |
| 普通文字 | 不因@或<被解释为读文件 |
怎样确认有效
以测试接口真正收到正确字段及完整文件内容为准。仅返回200不能证明服务端已保存或关联附件;实际业务仍需核对返回资源及上传后的可用性。样例字段upload是演示,不通用于所有API。
无效时恢复与下一步
保留原始文件和接口错误,移除本地测试产物后恢复原工作目录。若仍失败,检查接口方法、字段限制和身份权限,不通过禁用TLS、增加管理员权限或改变文件后缀绕过解析。