====== GET、PUT、POST 的区别 ======
这三个都是 HTTP 方法,但用途不同。一句话概括:
* **GET** —— 读取资源,只读、安全、幂等。
* **POST** —— 提交数据 / 创建资源,非幂等,重复提交可能产生多条记录。
* **PUT** —— 用请求体**整体替换**目标资源,幂等,重复提交结果相同。
===== 速查表 =====
^ 对比项 ^ GET ^ POST ^ PUT ^
| 语义 | 获取资源 | 提交数据 / 创建 | 整体替换资源 |
| 是否安全 | 安全(不改数据) | 不安全 | 不安全 |
| 幂等性 | 幂等 | 非幂等 | 幂等 |
| 数据位置 | URL 查询串 | 请求体 | 请求体 |
| 资源 ID | 在 URL 中 | 服务端生成 | 客户端指定 URL |
| 可缓存 | 可缓存 | 默认不可缓存 | 一般不可缓存 |
| 典型示例 | ''GET /users/1'' | ''POST /users'' | ''PUT /users/1'' |
> 判断的关键只有两条:**是否幂等**(重发一次结果是否一样)和**是否安全**(会不会改动数据)。
===== 思维导图 =====
下面是这三个方法的结构化对比:
```mdk height=560 color=#4f46e5
# 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**
* 新建一条记录,还不知道它的 URL → **POST** 到集合
* 已知完整 URL,要整体覆盖 → **PUT**
* 只想改其中几个字段 → **PATCH**(不属于这三者)
===== 请求示例 =====
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 由客户端指定
===== 注意事项 =====
* 用 GET 做增删改很危险:爬虫抓取、浏览器预取、网络重试都可能误触发。
* PUT 若只传部分字段,未传字段会被清空(整体替换语义),局部更新要用 PATCH。
* POST 在网络重试下可能重复创建,通常需要幂等键(''Idempotency-Key'')去重。
* 幂等的定义是「执行一次和执行多次,服务端最终状态相同」,指的是**状态**,不是响应码。