差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

后一修订版
前一修订版
get_put_post [2026/10/12 15:11] – 新建 get_put_post 页面并加入 GET/PUT/POST 对比思维导图 张叶安get_put_post [2026/10/12 15:12] (当前版本) – get_put_post 页面补充 DokuWiki 正文:用法选择、请求示例与注意事项 张叶安
行 1: 行 1:
 +====== 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 ```mdk height=560 color=#4f46e5
 # GET / PUT / POST 的区别 # GET / PUT / POST 的区别
行 50: 行 75:
 - 认为 POST 一定创建资源:它只是「非幂等提交」的通用语义 - 认为 POST 一定创建资源:它只是「非幂等提交」的通用语义
 ``` ```
 +
 +===== 什么时候用哪个 =====
 +
 +  * 只想取数据 → **GET**
 +  * 新建一条记录,还不知道它的 URL → **POST** 到集合
 +  * 已知完整 URL,要整体覆盖 → **PUT**
 +  * 只想改其中几个字段 → **PATCH**(不属于这三者)
 +
 +===== 请求示例 =====
 +
 +<code http>
 +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"}
 +</code>
 +
 +<code js>
 +// 三个方法对应三种语义
 +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 由客户端指定
 +</code>
 +
 +===== 注意事项 =====
 +
 +  * 用 GET 做增删改很危险:爬虫抓取、浏览器预取、网络重试都可能误触发。
 +  * PUT 若只传部分字段,未传字段会被清空(整体替换语义),局部更新要用 PATCH。
 +  * POST 在网络重试下可能重复创建,通常需要幂等键(''Idempotency-Key'')去重。
 +  * 幂等的定义是「执行一次和执行多次,服务端最终状态相同」,指的是**状态**,不是响应码。
  

该主题尚不存在

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

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