适用范围与准备

适用于获准测试的 multipart/form-data 接口:你想提交普通文本,值恰好以 @ 或 < 开头,curl 却尝试读取文件、报错 26,或服务收到意外的附件。先确认该字段需要文本而非真实文件上传。

先区分原因

--form 的值有特殊语法:@ 可上传文件,< 可读取文件作为字段内容,;type= 可参与类型设置。--form-string 将这些符号作为字面值处理,仍然发送 multipart 表单;它不是 JSON 编码,也不是 shell 命令转义工具。

按顺序操作

  1. 阅读接口文档,列清字段名称、哪些是文本、哪些确实是文件。对来自用户输入或外部数据的文本,不能因为通常不含 @ 就默认它总适合直接拼进 --form。
  2. 用下面的非敏感示例向自己的测试端点提交,确认 comment 字段应收到原样的 @./sample.txt;type=text/plain。示例不需要读取本地 sample.txt,也不应把它创建成真实用户文件。
  3. 在测试接收端检查字段原文、字段类型以及是否出现 filename 属性。若原意是文本却出现附件,回查是否仍用了 --form 或上游脚本重新解释了值。
  4. 接口确需附件时,可以为那个明确的文件字段保留 --form,并为文本字段用 --form-string。不要手写 multipart 边界或把整个表单强行标为 application/json;让 curl 按表单模式构造请求。
  5. 脚本中通过安全的参数数组传值,并避免 eval 或把外部文字拼成 shell 命令。--form-string 只限制 curl 的表单解释,不会防止 shell 先执行命令替换。
PowerShell;macOS/Linux 改为 curl。POST 仅用于获准测试端点,comment 的值是文字,不读本地文件。
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 退出成功不能证明字段类型和内容正确。

无效时恢复与下一步

撤销本次测试提交按测试系统规则处理,并保留改动前后的安全样例。若之前误传了真实文件,按文件敏感程度联系接收方并处理已暴露凭据,单改参数不能撤回已经发送的数据。