Path or query?一文搞懂后端接口四种传参方式
1 先记结论
1.1 CRUD 常用传参方式
| 操作 | HTTP 方法 | 常用传参方式 | 示例 |
|---|---|---|---|
| 新增 | POST | Body | POST /users |
| 删除 | DELETE | Path / Query | DELETE /users/1 |
| 修改 | PUT / PATCH | Path + Body | PUT /users/1 |
| 查询列表 | GET | Query | GET /users?page=1&size=10 |
| 查询详情 | GET | Path | GET /users/1 |
2 四种传参方式的区别
① Query(查询参数)
参数放在 URL 的 ? 后面,多个参数使用 & 连接。
1 | |
常用于分页、筛选、搜索,也可以用于删除。
② Path(路径参数)
参数直接放在 URL 路径中。
1 | |
通常用于根据 ID 查询、删除或修改指定资源。
③ Body(请求体参数)
参数放在请求体中,通常使用 JSON。
1 | |
常用于新增和修改。
④ Header(请求头参数)
1 | |
常用于传递 Token、认证信息、内容类型等。
3 Java中对应的注解
对应的注解如下:
| 参数类型 | Spring Boot 注解 |
|---|---|
| Query | @RequestParam |
| Path | @PathVariable |
| Body | @RequestBody |
| Header | @RequestHeader |
例如:
1 | |
最简单的记忆方式:
- 新增 POST → Body
- 删除 DELETE → Path(也可以 Query)
- 修改 PUT/PATCH → Path + Body
- 查询详情 GET → Path
- 查询列表 GET → Query
Path or query?一文搞懂后端接口四种传参方式
https://huichen.dev/2026/11/14/learning/Path or query?一文搞懂后端接口四种传参方式/