====== 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'')去重。 * 幂等的定义是「执行一次和执行多次,服务端最终状态相同」,指的是**状态**,不是响应码。