HTTP 请求方法指南：GET, POST, PUT, PATCH, DELETE 区别
Web 开发中，开发者每天都在与 API 打交道：用 GET 获取文章列表，用 POST 创建一个新用户... 但在这些常见操作的背后，每种 HTTP 方法都有其精确的语义和不可替代的场景。理解它们的差异是设计出优雅、可预测的 RESTful 服务的基石。本文将详细阐述这五种方法的用途、幂等性差异以及它们在实际开发中的应用。
以下是这五种方法的详细说明和区别：
基本定义
- GET： 用于从服务器检索信息。GET 请求应该是安全且幂等的，这意味着它只用于获取数据，不应改变服务器上的资源状态。 多次相同的 GET 请求应该返回相同的结果。
- POST： 用于向服务器提交数据，通常用于创建新资源。 POST 请求不是幂等的，连续发送相同的 POST 请求会创建多个新资源。
- DELETE： 用于删除服务器上的指定资源。 DELETE 请求是幂等的，即多次删除同一个资源的效果与一次删除相同。
- PUT： 用于创建或完全替换服务器上的资源。 PUT 请求是幂等的，多次发送相同的 PUT 请求将产生相同的结果。
- PATCH： 用于对资源进行部分修改。 PATCH 请求不是幂等的，其效果取决于资源的当前状态。
核心区别：PUT vs POST
PUT 和 POST 都可以用来创建或更新资源，但它们之间存在关键差异：
| 特性 | PUT | POST |
|---|---|---|
| 主要用途 | 替换或创建指定 URI 的资源 | 创建一个新资源 |
| 幂等性 | 是幂等的。 多次发送同一个 PUT 请求，服务器上的资源状态将保持一致。 | 不是幂等的。 多次发送同一个 POST 请求，会创建多个资源。 |
| URI 的作用 | URI 直接指向要修改或创建的那个资源。 | URI 通常指向一个资源集合，服务器会为新创建的资源分配一个新的 URI。 |
| 请求体 | 包含资源的完整表述，用于替换整个资源。 | 包含要创建的新资源的数据。 |
简单类比：
- PUT： 就像更新一个人的完整个人资料。无论提交多少次更新后的完整资料，这个人的最终资料都是最后一次提交的内容。
- POST： 就像在论坛上发帖子。每提交一次，就会多一个新帖子，即使内容完全一样。
核心区别：PUT vs PATCH
PUT 和 PATCH 都可以用来更新资源，但更新的方式不同：
| 特性 | PUT | PATCH |
|---|---|---|
| 更新方式 | 整体替换。 请求体中需要包含资源的完整数据。如果某个字段没有在请求中提供，那么该字段可能会被清空或设为默认值。 | 局部更新。 请求体中只需要包含需要修改的字段。未包含的字段将保持不变。 |
| 效率 | 对于只修改少量信息的场景，发送整个资源数据会比较低效。 | 只传输需要修改的数据，更加高效，节省带宽。 |
| 幂等性 | 是幂等的。 | 不一定是幂等的。 例如，一个 PATCH 请求是"将某个数值加 1"，那么多次请求的结果就不同。 |
简单类比：
- PUT： 假设一个用户有姓名和邮箱两个字段。如果只想更新邮箱，使用 PUT 请求时必须同时提供姓名和新的邮箱。
- PATCH： 在同样的情况下，使用 PATCH 请求只需要提供新的邮箱地址即可，姓名部分不受影响。
总结表格
| 方法 | 主要操作 | 是否幂等 (Idempotent) | 是否安全 (Safe) |
|---|---|---|---|
| GET | 查询/读取资源 | 是 | 是 |
| POST | 创建资源 | 否 | 否 |
| DELETE | 删除资源 | 是 | 否 |
| PUT | 替换/完整更新资源 | 是 | 否 |
| PATCH | 部分更新资源 | 否 | 否 |
幂等性 (Idempotency): 多次执行相同的操作，其结果与执行一次完全相同。
安全性 (Safety): 操作不会改变服务器上资源的状态。