curl POST失败主因是Content-Type与数据格式不匹配：-d默认x-www-form-urlencoded，发JSON需显式-H指定类型并确保-d为合法JSON字符串，上传文件必须用-F而非-d。
curl 发送 POST 请求失败，多半是 Content-Type 和数据格式没对上，不是命令写错，而是语义没匹配后端期待的解析方式。
curl -d 默认发的是 application/x-www-form-urlencoded
用 -d 发送键值对时，curl 会自动加 Content-Type: application/x-www-form-urlencoded，后端 PHP 的 $_POST 才能直接读到。如果后端是 Node.js 或 Python Flask，也默认支持这种编码。
- 正确写法：
curl -d "user=admin&passwd=12345678" https://api.example.com/login - 等价写法（多个
-d）：curl -d "user=admin" -d "passwd=12345678" https://api.example.com/login - 参数含空格或特殊字符？用
--data-urlencode替代-d，比如：curl --data-urlencode "name=John Doe" https://api.example.com - 参数太多？写进文件再引用：
curl -d @data.txt https://api.example.com，data.txt里就是user=admin&passwd=12345678
常见错误：明明用了 -d，但后端收不到 $_POST —— 很可能是你额外加了 -H "Content-Type: application/json"，导致 header 和 body 编码不一致，PHP 拒绝解析。
发 JSON 必须显式指定 -H 并确保 -d 是合法 JSON 字符串
JSON 不是默认编码，必须手动设 header，且 -d 后的内容得是完整、无换行、引号闭合的 JSON 文本。否则后端 json_decode(file_get_contents('php://input')) 会失败。
- 正确写法：
curl -H "Content-Type: application/json" -d '{"user":"admin","passwd":"12345678"}' https://api.example.com/login - 单引号包裹整个 JSON，避免 shell 把双引号吃掉；若 JSON 内含单引号，改用双引号包裹并转义内部双引号
- 调试时加
-v看真实发出的 header 和 body：curl -v -H "Content-Type: application/json" -d '{"x":1}' https://api.example.com - 别用
-d发多行 JSON：curl 不支持原生多行字符串，拼成一行或用jq格式化后再传
上传文件必须用 -F，不能用 -d
-F 会自动切换为 multipart/form-data 编码，并构造边界（boundary），这是浏览器表单上传的标准方式。-d 发二进制内容只会被当纯文本，后端根本收不到文件字段。
- 上传单个文件：
curl -F "file=@/path/to/photo.jpg" https://api.example.com/upload - 带额外字段（如 token）：
curl -F "file=@photo.jpg" -F "token=abc123" https://api.example.com/upload - 指定文件 MIME 类型：
curl -F "file=@photo.jpg;type=image/jpeg" https://api.example.com/upload - 上传多个同名字段（如多图）：
curl -F "images=@a.jpg" -F "images=@b.jpg" https://api.example.com/upload
注意：@ 符号不能漏，否则 curl 会把路径当文字发过去；路径必须存在，否则报 Can't read file 错误。
调试时加 -v 或配合 jq 看清响应结构
光看终端输出容易忽略 header、状态码、重定向跳转这些关键信息。-v 是最轻量的调试开关，而返回 JSON 时用 jq 可快速验证结构是否符合预期。
- 查状态码和 header：
curl -I https://api.example.com/health（只取 header）或curl -v https://api.example.com/login - 美化并过滤 JSON 响应：
curl -s https://api.example.com/users | jq '.data[].name' - 保存响应到文件分析：
curl -o response.json https://api.example.com/data - 模拟带 Cookie 的请求：
curl -b "sessionid=abc123" https://api.example.com/profile
真正容易被忽略的是：后端可能依赖特定 header（如 X-Requested-With）、要求非标准端口、或做了 referer 校验——这些都得靠 -v 看原始交互才能定位，而不是反复猜参数。
