适用范围与准备
适用于获准测试的 multipart/form-data 接口:你想提交普通文本,值恰好以 @ 或 < 开头,curl 却尝试读取文件、报错 26,或服务收到意外的附件。先确认该字段需要文本而非真实文件上传。
先区分原因
--form 的值有特殊语法:@ 可上传文件,< 可读取文件作为字段内容,;type= 可参与类型设置。--form-string 将这些符号作为字面值处理,仍然发送 multipart 表单;它不是 JSON 编码,也不是 shell 命令转义工具。
按顺序操作
- 阅读接口文档,列清字段名称、哪些是文本、哪些确实是文件。对来自用户输入或外部数据的文本,不能因为通常不含 @ 就默认它总适合直接拼进 --form。
- 用下面的非敏感示例向自己的测试端点提交,确认 comment 字段应收到原样的 @./sample.txt;type=text/plain。示例不需要读取本地 sample.txt,也不应把它创建成真实用户文件。
- 在测试接收端检查字段原文、字段类型以及是否出现 filename 属性。若原意是文本却出现附件,回查是否仍用了 --form 或上游脚本重新解释了值。
- 接口确需附件时,可以为那个明确的文件字段保留 --form,并为文本字段用 --form-string。不要手写 multipart 边界或把整个表单强行标为 application/json;让 curl 按表单模式构造请求。
- 脚本中通过安全的参数数组传值,并避免 eval 或把外部文字拼成 shell 命令。--form-string 只限制 curl 的表单解释,不会防止 shell 先执行命令替换。
curl.exe --disable --fail --connect-timeout 10 --max-time 30 --form-string "comment=@./sample.txt;type=text/plain" "https://example.com/test-form"| 意图 | 选择 |
|---|---|
| 普通文本,可能包含 @、< 或 ;type= | --form-string |
| 明确要上传某个文件 | --form,核对文件与接收方 |
| 整个请求体是原始文件字节 | --data-binary,按另一种接口约定 |
| 请求体必须是 JSON | 按 JSON 接口构造,不套 multipart |
怎样确认有效
接收端看到完整原样的文本字段,未出现意外附件,接口业务处理符合要求。再测试包含特殊字符的允许输入;只看 curl 退出成功不能证明字段类型和内容正确。
无效时恢复与下一步
撤销本次测试提交按测试系统规则处理,并保留改动前后的安全样例。若之前误传了真实文件,按文件敏感程度联系接收方并处理已暴露凭据,单改参数不能撤回已经发送的数据。