计算机网络 / 系统课时

使用 DELETE 删除资源

使用 DELETE 删除资源

DELETE 用于请求服务器解除目标 URI 与当前资源之间的关联。实际项目中,它可以对应物理删除、软删除或归档;客户端更需要掌握的是接口语义、成功状态码,以及同一删除请求被重复发送时应如何处理。

学习目标

  • 理解 DELETE 的删除语义,以及它与数据库物理删除的区别。
  • 能根据同步、异步和需要返回结果的场景选择 204、200 或 202。
  • 能正确设计重复 DELETE 的行为,并理解幂等不等于每次响应完全相同。

DELETE 删除的是资源关联

例如文章资源使用 /articles/42 标识,客户端可以向这个 URI 发送 DELETE。HTTP 并不要求服务器一定执行 DELETE FROM articles:服务端完全可以把记录标记为已删除、移入归档表,或撤销 URI 对外提供该资源的能力。

片段示例:以下命令假设本地测试服务已经提供 DELETE /articles/42,并约定同步删除成功后返回 204。

bash
curl -i -X DELETE http://localhost:8080/articles/42

预期输出:

text
HTTP/1.1 204 No Content

204 响应没有消息内容,因此客户端不应继续等待 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 条件删除。

bash
curl -i -X DELETE http://localhost:8080/articles/42 -H 'If-Match: "v7"'

预期结果:当服务器当前版本仍为 "v7" 时可按接口约定返回 204;如果资源已经被更新为其他版本,则应拒绝这个过期删除请求,例如返回:

text
HTTP/1.1 412 Precondition Failed

这样 DELETE 表达的仍然是删除目标资源,但真正执行前增加了版本条件。对于后台异步删除、软删除和带业务副作用的接口,也应分别明确完成时机、重复调用行为和最终可观察状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 DELETE 删除资源

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通