差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| 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** —— 用请求体**整体替换**目标资源,幂等,重复提交结果相同。 | ||
| + | |||
| + | ===== 速查表 ===== | ||
| + | |||
| + | ^ 对比项 | ||
| + | | 语义 | ||
| + | | 是否安全 | ||
| + | | 幂等性 | ||
| + | | 数据位置 | ||
| + | | 资源 ID | 在 URL 中 | 服务端生成 | ||
| + | | 可缓存 | ||
| + | | 典型示例 | ||
| + | |||
| + | > 判断的关键只有两条:**是否幂等**(重发一次结果是否一样)和**是否安全**(会不会改动数据)。 | ||
| + | |||
| + | ===== 思维导图 ===== | ||
| + | |||
| + | 下面是这三个方法的结构化对比: | ||
| + | |||
| ```mdk height=560 color=# | ```mdk height=560 color=# | ||
| # 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: | ||
| + | |||
| + | {" | ||
| + | |||
| + | PUT /users/1 HTTP/1.1 | ||
| + | Host: api.example.com | ||
| + | Content-Type: | ||
| + | |||
| + | {" | ||
| + | </ | ||
| + | |||
| + | <code js> | ||
| + | // 三个方法对应三种语义 | ||
| + | await fetch("/ | ||
| + | await fetch("/ | ||
| + | await fetch("/ | ||
| + | </ | ||
| + | |||
| + | ===== 注意事项 ===== | ||
| + | |||
| + | * 用 GET 做增删改很危险:爬虫抓取、浏览器预取、网络重试都可能误触发。 | ||
| + | * PUT 若只传部分字段,未传字段会被清空(整体替换语义),局部更新要用 PATCH。 | ||
| + | * POST 在网络重试下可能重复创建,通常需要幂等键('' | ||
| + | * 幂等的定义是「执行一次和执行多次,服务端最终状态相同」,指的是**状态**,不是响应码。 | ||