当接口达到连接上限时，最适合的HTTP状态码是什么？

问题描述 #

当某个接口仅允许有限数量的连接（例如视频通话接口、票务网站排队接口），当接口已“满”、客户端无法接入时，返回哪种HTTP状态码最为合适？我考虑过以下几种，但均不太满意：

• 423 Locked - 通常表示其他客户端暂时占用了资源，是目前最接近的选项，但仍不够贴切
• 429 Too Many Requests - 通常指客户端发送请求过多，而非整体连接数已满
• 409 Conflict - 通常用于资源合并冲突场景
• 400 Bad Request - 是无法处理请求的通用 fallback，但此处请求本身无问题，只是时机过晚

是否有我忽略的更合适的选项？

最佳答案 #

优先选择 503 Service Unavailable #

你之前考虑的都是4xx客户端错误码，但这类场景更适合使用5xx服务端错误码中的503 Service Unavailable。

根据HTTP标准定义，503用于表示服务暂时无法处理请求，常见原因就是服务过载或维护，完美匹配接口连接数已满、暂时无法接纳新请求的场景。同时你可以搭配Retry-After响应头，告知客户端大致的重试时间，这对票务排队、视频通话这类需要用户后续尝试的场景非常友好。

为什么排除其他选项？ #

再明确下你提到的几个选项的不匹配点：

• 423 Locked：核心语义是资源被"锁定"（比如文件正在被编辑），和连接数上限的场景完全不搭
• 429 Too Many Requests：是针对单个客户端的请求频率限制，而非服务端整体的容量上限
• 409 Conflict：用于资源状态冲突（比如多用户编辑同一资源的版本冲突），和当前场景无关
• 400 Bad Request：会让客户端误以为请求格式或参数有误，不符合实际情况

如果需要更清晰的业务语义，还可以在503的响应体中添加自定义描述（例如"当前排队人数已满，请稍后再试"），帮助客户端更精准地处理该状态。

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