HTTP 状态码 - HttpStatus

简介

HttpStatus 是 Hutool 提供的一个工具类，用于保存常见的 HTTP 状态码的常量定义。这些状态码的定义符合 HTTP 标准协议，便于在项目中直接引用这些常量，提升代码的可读性和维护性。每个状态码都以描述性的常量命名，如 HTTP_OK 代表状态码 200，HTTP_NOT_FOUND 代表状态码 404 等。

1. HTTP 成功状态码

常见的 HTTP 成功状态码表示请求已成功被服务器处理。

示例：使用成功状态码常量

import cn.hutool.http.HttpStatus;

public class HttpStatusExample {
    public static void main(String[] args) {
        // 状态码 200: OK
        if (responseStatusCode == HttpStatus.HTTP_OK) {
            System.out.println("请求成功！");
        }

        // 状态码 201: Created
        if (responseStatusCode == HttpStatus.HTTP_CREATED) {
            System.out.println("资源已成功创建！");
        }
    }
}

• HTTP_OK (200)：表示请求成功，服务器返回所请求的数据。
• HTTP_CREATED (201)：表示请求已成功，并且服务器创建了新的资源。

作用： 在处理 HTTP 响应时，使用这些常量可以提高代码的可读性，便于判断请求是否成功。

实际开发场景： 在 Web 应用中，通常需要判断接口请求是否成功，并基于状态码做出不同的处理。

2. HTTP 客户端错误状态码

客户端错误状态码表示请求存在问题，例如请求的资源不存在、请求格式不正确等。

示例：使用客户端错误状态码常量

import cn.hutool.http.HttpStatus;

public class HttpStatusExample {
    public static void main(String[] args) {
        // 状态码 400: Bad Request
        if (responseStatusCode == HttpStatus.HTTP_BAD_REQUEST) {
            System.out.println("请求格式错误，请检查请求数据！");
        }

        // 状态码 404: Not Found
        if (responseStatusCode == HttpStatus.HTTP_NOT_FOUND) {
            System.out.println("请求的资源不存在！");
        }
    }
}

• HTTP_BAD_REQUEST (400)：表示客户端发送了错误请求，服务器无法处理。
• HTTP_NOT_FOUND (404)：表示请求的资源不存在，通常是因为 URL 不正确。

作用： 在处理客户端请求错误时，可以根据不同的状态码进行错误提示或重试操作。

实际开发场景： 在开发 RESTful 接口时，前端需要根据状态码判断是数据问题、路径问题还是其他客户端错误。

3. HTTP 服务器错误状态码

服务器错误状态码表示服务器在处理请求时发生了错误，通常是服务器端的问题。

示例：使用服务器错误状态码常量

import cn.hutool.http.HttpStatus;

public class HttpStatusExample {
    public static void main(String[] args) {
        // 状态码 500: Internal Server Error
        if (responseStatusCode == HttpStatus.HTTP_INTERNAL_ERROR) {
            System.out.println("服务器内部错误，请稍后重试！");
        }

        // 状态码 503: Service Unavailable
        if (responseStatusCode == HttpStatus.HTTP_UNAVAILABLE) {
            System.out.println("服务不可用，可能正在维护中！");
        }
    }
}

• HTTP_INTERNAL_ERROR (500)：表示服务器遇到了未预料的情况，无法完成请求。
• HTTP_UNAVAILABLE (503)：表示服务器当前无法处理请求，通常是因为服务器过载或正在维护。

作用： 在处理服务器端错误时，可以根据状态码提示用户稍后重试或联系支持团队。

实际开发场景： 在部署 Web 服务时，可能会遇到服务器故障，返回 500 或 503 状态码，此时可以通过这些状态码做出相应的处理。

4. 常用 HTTP 状态码总结

下面是一些常见的 HTTP 状态码及其含义的总结：

• HTTP_CONTINUE (100)：继续，部分请求已收到，需继续处理。
• HTTP_OK (200)：请求成功。
• HTTP_CREATED (201)：请求成功并且资源被创建。
• HTTP_NO_CONTENT (204)：请求成功，但没有内容返回。
• HTTP_MOVED_TEMP (302)：请求重定向到其他 URL。
• HTTP_BAD_REQUEST (400)：客户端请求格式错误。
• HTTP_UNAUTHORIZED (401)：请求需要用户认证。
• HTTP_FORBIDDEN (403)：服务器拒绝执行请求。
• HTTP_NOT_FOUND (404)：请求的资源不存在。
• HTTP_INTERNAL_ERROR (500)：服务器内部错误。
• HTTP_UNAVAILABLE (503)：服务不可用，通常因为服务器过载或维护。

作用： 这些状态码常量在处理 HTTP 请求和响应时，可以直接引用，提升代码的规范性和可读性。

实际开发场景： 在处理 API 请求的结果时，通常需要根据状态码判断请求的成功与失败，并根据不同的错误状态返回相应的提示或处理策略。