这三个都是 HTTP 方法,但用途不同。一句话概括:
| 对比项 | GET | POST | PUT |
|---|---|---|---|
| 语义 | 获取资源 | 提交数据 / 创建 | 整体替换资源 |
| 是否安全 | 安全(不改数据) | 不安全 | 不安全 |
| 幂等性 | 幂等 | 非幂等 | 幂等 |
| 数据位置 | URL 查询串 | 请求体 | 请求体 |
| 资源 ID | 在 URL 中 | 服务端生成 | 客户端指定 URL |
| 可缓存 | 可缓存 | 默认不可缓存 | 一般不可缓存 |
| 典型示例 | GET /users/1 | POST /users | PUT /users/1 |
判断的关键只有两条:**是否幂等**(重发一次结果是否一样)和**是否安全**(会不会改动数据)。
下面是这三个方法的结构化对比:
# GET / PUT / POST 的区别 ## GET — 读取 - 语义:获取资源,只读 - 安全:不改变服务端数据 - 幂等:重复请求结果一致 - 数据位置:URL 查询串 ?a=1&b=2 - 规范上不带语义化请求体 - 可缓存、可书签、可回退、可被预取 - 示例:GET /users/1 ## POST — 提交 / 创建 - 语义:提交数据、创建资源、触发处理 - 非安全、非幂等 - 数据位置:请求体 - 由服务端决定新资源 ID - 默认不可缓存 - 重复提交可能产生多条记录 - 示例:POST /users ## PUT — 整体替换 - 语义:用请求体整体替换目标资源 - 非安全,但幂等 - 数据位置:请求体,需带完整资源表示 - 由客户端指定 URL / 资源 ID - 重复提交结果相同 - 示例:PUT /users/1 - 只传部分字段会清空未传字段 → 部分更新应用 PATCH ## 三个维度对比 ### 幂等性 - GET:幂等 - PUT:幂等 - POST:不幂等 ### 是否安全(不改数据) - GET:安全 - PUT / POST:不安全 ### 数据放哪里 - GET:URL 查询串 - PUT / POST:请求体 ### 谁来定 ID - POST:服务端生成 - PUT:客户端指定 ## 常见误区 - 用 GET 做增删改:可能被爬虫、预取、浏览器重放触发 - 用 POST 做幂等更新:网络重试会重复执行 - 把 PUT 当 PATCH 用:未传字段被置空 - 认为 POST 一定创建资源:它只是「非幂等提交」的通用语义
GET /users/1 HTTP/1.1
Host: api.example.com
POST /users HTTP/1.1
Host: api.example.com
Content-Type: application/json
{"name":"张三","email":"a@example.com"}
PUT /users/1 HTTP/1.1
Host: api.example.com
Content-Type: application/json
{"id":1,"name":"张三","email":"b@example.com"}
// 三个方法对应三种语义
await fetch("/users/1"); // GET:读
await fetch("/users", { method: "POST", body: JSON.stringify(user) }); // 创建,ID 由服务端生成
await fetch("/users/1", { method: "PUT", body: JSON.stringify(user) }); // 整体替换,ID 由客户端指定
Idempotency-Key)去重。