解决 curl 用 GET 请求发送 JSON 数据服务器收不到的问题

对于许多初学者而言，使用 curl 通过 GET 请求发送 JSON 数据后，发现后端始终收不到，是一个令人困惑的典型场景。本篇教程将深入分析问题根源，并提供两种彻底可靠的解决方案。

为什么 GET 请求的 JSON 数据会“消失”

出现该问题的核心原因是：GET 请求通常被设计为从服务器获取资源，其参数主要通过 URL 的查询字符串（Query String）传递。RFC 7231 虽然允许 HTTP GET 请求携带请求体（Body），但同时指出该请求体不具备普遍定义的语义，服务器无义务解析或处理它。在实际工程中，主流语言框架（如 Express、Spring Boot、Flask）的默认行为几乎都是直接丢弃 GET 请求的 Body，甚至反向代理（如 Nginx）、日志系统也会将其剥离。因此，当你这样执行 curl 时，服务器日志可能连请求体内容都看不到：

curl -X GET http://localhost:8080/api/user \
  -H "Content-Type: application/json" \
  -d '{"name":"John","age":30}'

上面的命令中，-d 参数将 JSON 放置在了请求体里，但对于 GET 方法，后端往往只解析 URL 上的参数，导致 name 与 age 永远无法被接收。

解决方案一：将 JSON 数据转为查询参数（推荐用于简单数据）

如果你的 JSON 数据结构扁平、字段不多，最符合 HTTP 规范的做法是将其转化为 URL 查询字符串。curl 提供了 --data-urlencode 或手动拼接两种方式。

使用 --data-urlencode 自动编码

curl -G http://localhost:8080/api/user \
  --data-urlencode "name=John" \
  --data-urlencode "age=30"

• -G 会强制 curl 使用 GET 方法，并将所有 --data-urlencode 的数据以 ?key=value 形式拼接到 URL 尾部，自动处理特殊字符的转义。

手动构建 URL

curl "http://localhost:8080/api/user?name=John&age=30"

服务器端即可通过常规的查询参数解析方法获取这些值，例如在 Node.js 中：

// Express 示例
app.get('/api/user', (req, res) => {
  const name = req.query.name;  // "John"
  const age = req.query.age;    // "30"
});

解决方案二：改用 POST 请求（推荐用于复杂 JSON）

当 JSON 数据嵌套层级深、包含数组或结构复杂时，硬塞进 URL 既不安全也不可行。此时应改用语义正确的 POST 请求来提交数据。

curl -X POST http://localhost:8080/api/user \
  -H "Content-Type: application/json" \
  -d '{"name":"John","age":30,"roles":["admin","editor"]}'

后端接收代码示例（Node.js）：

app.use(express.json()); // 解析 JSON body

app.post('/api/user', (req, res) => {
  const user = req.body;   // 完整获取 JSON 对象
  res.send(`用户 ${user.name} 创建成功`);
});

为什么我的服务器还是收不到数据？自查清单

即使用了上面的方案，仍可能遇到问题，请逐项检查：

1. 服务端路由是否正确：确保后端定义了对应的 GET 路由（使用查询参数）或 POST 路由。
2. Content-Type 头：如果使用 POST 发送 JSON，必须设置 Content-Type: application/json，否则很多框架不会自动解析 Body。
3. 防火墙 / 代理拦截：某些网关可能会剔除 GET 请求的 Body，但不会影响 POST 和 Query String。
4. URL 长度限制：查询字符串承载过多数据可能被服务器或浏览器截断，此时必须改用 POST。

最佳实践总结

• 永远不要通过 GET 请求的 Body 传递业务数据，即使 HTTP 协议允许，实践中也充满了陷阱。
• 简单扁平的数据用 查询参数（-G + --data-urlencode）。
• 复杂数据结构或写操作直接用 POST + JSON body。
• 如果第三方 API 文档要求 “GET with JSON body”，通常意味着它的设计不规范，建议联系提供方确认。