计算机网络 / 系统课时
区分 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。可靠的做法是让删除流程保留足够的生命周期信息,例如墓碑记录、删除事件或资源状态字段,再据此判断服务器是否确实知道资源已永久移除。
- URI 能解析到现有资源时,正常返回资源对应的成功状态。
- 找不到资源且没有可靠历史记录时,返回 404。
- 有明确永久删除记录且不需要隐藏历史时,返回 410。
- 有替代 URI 时,优先判断是否应该使用 301 或 308 重定向。
- 涉及敏感对象时,再检查暴露“曾经存在”这一事实是否符合安全策略。
例如订单系统保留 deleted_at 和永久删除标记。订单 A1024 有明确删除记录且允许公开删除状态,可以返回 410;随机输入的 A9999 没有任何历史记录,则返回 404。
常见误用与修正
| 错误做法 | 问题 | 修正 |
|---|---|---|
| 查询为空就返回 410 | 无法证明资源曾存在且永久删除 | 没有生命周期证据时返回 404 |
| 永久换了新地址仍返回 410 | 客户端无法发现替代资源 | 使用 301 或 308 并提供 Location |
| 所有已删除对象都公开返回 410 | 可能泄露敏感对象曾经存在 | 按安全策略统一返回 404 |
| 临时下线使用 410 | 向客户端错误表达永久性 | 临时故障或维护应选择符合实际原因的状态码 |
判断这两个状态码时,可以直接问服务器一个问题:“我是否确定这个 URI 对应的资源已经永久退出生命周期?”答案不确定时使用 404;只有答案明确、没有替代位置且允许公开这一事实时,410 才表达得更准确。