计算机网络 / 系统课时

区分 404 与 410

区分 404 与 410

404 和 410 都可能表示客户端拿不到目标资源,但两者对资源生命周期的表达不同。404 不承诺资源以后是否会出现,410 则明确表达服务器知道该资源已经被永久移除。选择状态码前,应先确认服务器是否掌握“永久删除”这一事实。

学习目标

  • 根据资源生命周期选择 404 或 410。
  • 判断永久删除、未知资源和资源迁移应如何表达。
  • 避免用 410 泄露本来需要隐藏的资源历史。

404 表示当前找不到

404 Not Found 表示服务器没有找到目标资源的当前表示,或者服务器不愿意确认该资源是否存在。它并不说明这种状态是临时还是永久,因此特别适合服务器无法确定资源历史的情况。

场景 推荐状态码 原因
请求 /users/987654,系统从未有过这个 ID 404 当前不存在,也没有永久删除事实需要表达
客户端把 /products/42 写成 /product/42 404 路径无法匹配现有资源
资源可能以后重新创建 404 不应声明它永久消失
为隐藏受保护资源是否存在而拒绝披露 404 可以减少资源枚举带来的信息泄露

例如商品 ID 8421 查询不到,而系统只知道数据库里“没有这条记录”,就应返回 404。不要仅凭“现在没有”推断它一定曾经存在,更不要因此自动升级成 410。

410 表示明确永久移除

410 Gone 适用于服务器知道资源过去存在,并且已经被有意永久移除的情况。它比 404 多传递了一条生命周期信息:客户端不应该期待同一个 URI 在正常情况下再次恢复为原资源。

一个实际案例是旧活动页 /campaign/summer-2025。运营系统记录该页面已于 2025 年 9 月 1 日永久下线,且没有替代页面,这时使用 410 能明确表达该 URI 的终止状态。

如果资源只是迁移到新地址,不要用 410。永久迁移通常应该返回 301 或 308,并在 Location 中提供新 URI,让客户端能够继续访问替代资源。410 更适合“永久删除且没有应该跳转到的新位置”。

用生命周期记录做决定

不要根据“数据库查询为空”直接决定 410。可靠的做法是让删除流程保留足够的生命周期信息,例如墓碑记录、删除事件或资源状态字段,再据此判断服务器是否确实知道资源已永久移除。

  1. URI 能解析到现有资源时,正常返回资源对应的成功状态。
  2. 找不到资源且没有可靠历史记录时,返回 404。
  3. 有明确永久删除记录且不需要隐藏历史时,返回 410。
  4. 有替代 URI 时,优先判断是否应该使用 301 或 308 重定向。
  5. 涉及敏感对象时,再检查暴露“曾经存在”这一事实是否符合安全策略。

例如订单系统保留 deleted_at 和永久删除标记。订单 A1024 有明确删除记录且允许公开删除状态,可以返回 410;随机输入的 A9999 没有任何历史记录,则返回 404。

常见误用与修正

错误做法 问题 修正
查询为空就返回 410 无法证明资源曾存在且永久删除 没有生命周期证据时返回 404
永久换了新地址仍返回 410 客户端无法发现替代资源 使用 301 或 308 并提供 Location
所有已删除对象都公开返回 410 可能泄露敏感对象曾经存在 按安全策略统一返回 404
临时下线使用 410 向客户端错误表达永久性 临时故障或维护应选择符合实际原因的状态码

判断这两个状态码时,可以直接问服务器一个问题:“我是否确定这个 URI 对应的资源已经永久退出生命周期?”答案不确定时使用 404;只有答案明确、没有替代位置且允许公开这一事实时,410 才表达得更准确。

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

目录与阅读设置

阅读设置

17

记录一个想法

区分 404 与 410

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

登录哪都通