GET、PUT、POST 的区别

这三个都是 HTTP 方法,但用途不同。一句话概括:

  • GET —— 读取资源,只读、安全、幂等。
  • POST —— 提交数据 / 创建资源,非幂等,重复提交可能产生多条记录。
  • PUT —— 用请求体整体替换目标资源,幂等,重复提交结果相同。
对比项 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
  • 新建一条记录,还不知道它的 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)去重。
  • 幂等的定义是「执行一次和执行多次,服务端最终状态相同」,指的是状态,不是响应码。

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • get_put_post.txt
  • 最后更改: 2026/10/12 15:12
  • 由 张叶安