状态码在后端开发中常常遇到的场景

状态码在后端开发中常常遇到的场景

状态码分类概述

1xx状态码通常用于通信过程中的中间响应，表明服务器正在处理请求。
2xx状态码表示请求已成功被服务器接收、理解并接受。
xx状态码用于重定向，通知客户端需要用不同的URI重新发送请求。
4xx状态码表示客户端错误，如请求语法错误、请求无效等。
5xx状态码表示服务器错误，服务器未能实现合法请求。

实际开发场景应用场景

1. 200 OK - 成功状态码

• 场景：客户端请求成功，服务器正常响应请求。
• Spring Cloud Gateway：在路由配置正确且下游服务正常时返回。
• ginx：当请求的资源存在且客户端有权限访问时返回。

2. 01 Moved Permanently - 永久重定向

• 场景：请求的资源已被永久移动到新位置。
• Spring Cloud Gateway：使用path谓语和rewritePath过滤器实现URL重写，返回01状态码。

. 02 Found - 临时重定向

• 场景：请求的资源临时移动到另一个URI。
• ginx：配置重定向规则，如return 02，实现URL临时跳转。

4. 401 Unauthorized - 未授权

• 场景：请求未通过身份验证。
• Spring Security：当用户未登录或令牌无效时，Spring Security返回401状态码。

5. 40 Forbidden - 禁止访问

• 场景：服务器理解请求但拒绝执行。
• ginx：在权限控制中，如果用户没有访问权限，ginx返回40状态码。

6. 404 ot Found - 未到

• 场景：服务器无法到请求的资源。
• 通用：任何服务器在未到资源时都可能返回404，如Spring Boot应用或ginx服务器。

7. 499 Client Closed Request - 客户端关闭连接

场景：在服务器还在处理请求时，客户端已经关闭了连接。 ginx：当ginx作为Web服务器正在处理请求，但客户端在响应发送前断开了连接，ginx可能会记录499状态码。这种情况可能由网络问题、客户端程序错误或客户端机器故障引起。

8. 500 Internal Server Error - 服务器内部错误

• 场景：服务器遇到错误，无法完成请求。
• Spring Boot：当后端服务发生异常时，如果没有特定的异常处理器，将返回500状态码。
• ginx：后端服务故障或ginx配置错误时返回500。

9. 502 Bad Gateway - 错误的网关

• 场景：作为网关或代理的服务器从上游服务器收到无效响应。
• ginx：在ginx作为反向代理时，如果后端服务未正确响应，可能会返回502状态码。

10. 50 Service Unavailable - 服务不可用

• 场景：服务器暂时过载或维护，无法处理请求。
• Spring Cloud Gateway：结合Spring Cloud Circuit Breaker，当下游服务不可用时，可以配置返回50状态码。

11. 504 Gateway Timeout - 网关超时

• 场景：服务器作为网关或代理，但没有及时从上游服务器收到响应。
• ginx：在ginx配置的超时设置不当或后端服务响应过慢时，可能会返回504状态码。

其他状态码

• 41 Payload Too Large：请求体过大，服务器无法处理，如上传文件超过大小限制。
• 429 Too Many Requests：请求过多，服务器拒绝处理，通常用于限流。

以下是将上述状态码及其在后端开发中常见场景的描述汇总成表格的形式：