计算机网络 / 系统课时
使用 DELETE 删除资源
使用 DELETE 删除资源
DELETE 用于请求服务器解除目标 URI 与当前资源之间的关联。实际项目中,它可以对应物理删除、软删除或归档;客户端更需要掌握的是接口语义、成功状态码,以及同一删除请求被重复发送时应如何处理。
学习目标
- 理解 DELETE 的删除语义,以及它与数据库物理删除的区别。
- 能根据同步、异步和需要返回结果的场景选择 204、200 或 202。
- 能正确设计重复 DELETE 的行为,并理解幂等不等于每次响应完全相同。
DELETE 删除的是资源关联
例如文章资源使用 /articles/42 标识,客户端可以向这个 URI 发送 DELETE。HTTP 并不要求服务器一定执行 DELETE FROM articles:服务端完全可以把记录标记为已删除、移入归档表,或撤销 URI 对外提供该资源的能力。
片段示例:以下命令假设本地测试服务已经提供 DELETE /articles/42,并约定同步删除成功后返回 204。
curl -i -X DELETE http://localhost:8080/articles/42预期输出:
HTTP/1.1 204 No Content204 响应没有消息内容,因此客户端不应继续等待 JSON。DELETE 请求内容没有通用语义,除非接口文档明确约定,否则不要把“删除原因”“删除选项”等参数随意塞进 DELETE 请求体。
为删除结果选择响应状态
删除接口不必全部返回 204。响应应与服务端实际执行阶段匹配,客户端则按状态码决定是否继续等待、读取响应内容或查询任务状态。
| 场景 | 常用状态 | 具体含义 |
|---|---|---|
| 已同步删除且无需返回信息 | 204 No Content |
操作已完成,响应没有内容 |
| 已删除且需要返回结果说明 | 200 OK |
响应内容可描述删除结果 |
| 已接收但由后台任务执行 | 202 Accepted |
请求已接受,删除尚未保证完成 |
| 目标资源当前不存在 | 404 Not Found |
URI 当前没有可提供的目标资源 |
例如批量附件清理由后台队列执行时,立即返回 204 会让调用方误以为清理已经完成。更合适的做法是返回 202,并通过任务资源或其他明确机制让客户端检查后续结果。
重复调用仍要保持幂等
DELETE 属于幂等方法:对同一个目标连续执行相同请求,重复调用不应不断产生新的目标状态变化。第一次删除文章 42 后,再删除一次,文章不应因为第二次请求又触发一次独立的业务删除效果。
幂等并不要求两次 HTTP 响应完全一致。一种常见设计是第一次返回 204,第二次因为资源已经不存在而返回 404;另一种接口也可以把“已经不存在”视为目标状态已满足,重复返回 204。关键是提前固定接口契约。
如果删除操作还会扣费、发放补偿或发送通知,必须把这些副作用放进同一次幂等边界。错误做法是每收到一次 DELETE 都再次发通知或再次扣减计数;正确做法是先确认资源尚未进入删除状态,再执行一次性副作用。
防止删除过期版本
多人同时编辑资源时,仅凭资源 ID 删除可能误删他人刚更新的版本。接口支持条件请求时,可以要求客户端携带最近读取到的 ETag,服务端只在版本仍匹配时执行删除;版本已经变化则拒绝操作。
片段示例:以下命令假设本地服务为文章 42 返回过 ETag "v7",并实现了 If-Match 条件删除。
curl -i -X DELETE http://localhost:8080/articles/42 -H 'If-Match: "v7"'预期结果:当服务器当前版本仍为 "v7" 时可按接口约定返回 204;如果资源已经被更新为其他版本,则应拒绝这个过期删除请求,例如返回:
HTTP/1.1 412 Precondition Failed这样 DELETE 表达的仍然是删除目标资源,但真正执行前增加了版本条件。对于后台异步删除、软删除和带业务副作用的接口,也应分别明确完成时机、重复调用行为和最终可观察状态。