requst payload和query string parameters

kirinlau2025-11-11 17:38

很多人经常遇到这个问题，自己明明发起了post请求，为什么参数还是拼接在在了api端口后面，而且参数不是requst payload而是query string parameters。排查半天找不到其实很简单，往往是最简单的最有迷惑性

在使用某些 HTTP 库（如 Axios）时，params 会将参数拼接到 URL 上（变成 Query String），而 data 才是放在请求体（Request Payload）里的。

✅ 正确做法：

js 复制代码

axios.post('/api/endpoint', {
  name: 'Alice',
  age: 25
})
// 或显式指定 data
axios({
  method: 'post',
  url: '/api/endpoint',
  data: {    // ←←← 这里放请求体内容（Request Payload）
    name: 'Alice',
    age: 25
  }
})

❌ 错误做法（变成了 Query String）：

js 复制代码

axios({
  method: 'post',
  url: '/api/endpoint',
  params: {  // ←←← 这会变成 /api/endpoint?name=Alice&age=25
    name: 'Alice',
    age: 25
  }
})

💡 新手常见误区

属性	效果	属于
`params`	参数加到 URL 上，成为 `?key=value&...`	Query String Parameters
`data`	参数放到请求体中	Request Payload（POST/PUT 数据主体）

🔑 所以：POST + data = 真正的 Request Payload

🚫 别再犯：

POST 请求用 params 发主要数据 ❌- 后端用 req.body 却前端用 params ❌
看请求时只关注方法不看 payload / query ❌

✅ 最终建议：

如果你的 POST 请求需要传数据到 Request Payload：

就用 .post(url, data) 或者 { data: ... }，别用 params