POST重复请求在原有请求仍处理中时应返回的HTTP错误码是什么

结论 #

该场景下应返回 409 Conflict，返回429是错误选择。

原因说明 #

• 429 Too Many Requests的适用场景为速率限制：仅当客户端在单位时间内的请求总频次超出服务器预设阈值时使用，和单个请求的资源状态无关，本质是对客户端整体请求频率的管控，不符合你的场景特征。
• 409 Conflict的适用场景为请求与服务端当前资源状态冲突：完全匹配「同一创建请求仍处于处理中，重复提交和当前服务端处理状态产生临时冲突」的场景，且该冲突属于临时状态，客户端不需要修改任何请求内容，仅需等待前序请求处理完成后重试即可，完全符合你的业务要求。

最佳实践建议 #

你可以在返回409响应时额外携带Retry-After响应头，明确告知客户端建议的重试等待时间，减少无效重试的频次。如果业务允许，也可以要求客户端发起POST创建请求时携带Idempotency-Key请求头，服务端可以通过该键值直接识别重复请求，匹配到仍在处理中的前序请求时可选择挂起当前请求、等前序处理完成后直接返回对应结果，进一步降低客户端的重试成本。

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