REST API针对已过期订单更新请求应返回何种HTTP状态码？

这个问题抓得很准——请求格式完全合规，但业务层面订单已过期无法处理，选对状态码能让调用方瞬间明白问题根源，而不是在"是不是我请求写错了"里打转。

首选状态码：410 Gone #

HTTP规范里，410的语义是「目标资源已被永久移除，且没有可预见的恢复可能」。放到你的场景里，过期订单本质上已经不再是一个"可被操作的有效资源"了——它曾经存在，但现在彻底失效，任何更新请求都无法被执行。用410能精准传递这个信息：不是请求错了，是你要操作的订单已经彻底没效了。

别踩这些坑：避免误用其他状态码 #

• 不要用400 Bad Request：400是给请求格式、参数校验失败准备的（比如传了非数字的订单ID、必填字段缺失），你的请求本身是合法的，用400会误导调用方以为自己的请求格式有问题，浪费排查时间。
• 不要用404 Not Found：404表示资源压根不存在，但这里订单是真实存在过的，只是过期了。404没法传达「曾经存在但现在不可用」的核心信息。
• 谨慎用403 Forbidden：403更多指向权限问题（比如你没有操作这个订单的权限），但这里不管谁来操作，过期订单都不能被更新，和权限无关，所以403语义不符。

额外优化：配合清晰的响应体 #

返回410的同时，在响应体里加上具体的业务说明，能让调用方更省心，比如：

{
  "errorCode": "ORDER_EXPIRED",
  "errorMessage": "订单#12345已过期，无法进行更新操作",
  "expirationTimestamp": "2024-05-20T18:00:00Z"
}

内容的提问来源于stack exchange，提问作者Andremoniy