Java中响应体 Result 怎么统一封装全局异常信息-java教程-PHP中文网

Java中响应体Result统一封装全局异常信息，核心是让所有异常统一转为结构一致的JSON响应；Result泛型类含code、message、data三字段，推荐增加timestamp和requestId；用枚举管理错误码，自定义BusinessException并配合@ControllerAdvice分层捕获处理，控制器专注业务逻辑。

java中响应体 result 怎么统一封装全局异常信息

Java中响应体Result统一封装全局异常信息，核心是让所有异常——无论参数校验失败、业务规则不满足，还是系统内部错误——最终都转成结构一致的JSON响应，前端只对接一种格式，后端也不用每个接口手动处理异常。

定义清晰的Result泛型类

Result必须包含三个基础字段：code（int类型错误码）、message（面向用户或调试人员的提示）、data（泛型T，成功时有值，异常时为null）。不建议加success布尔字段，它和code语义重复，还容易引发前端双重判断逻辑错乱。

可选但推荐增加：timestamp（毫秒时间戳）用于排查异步或重放问题；requestId（唯一请求ID）便于日志追踪与监控对齐。

示例关键代码：

public class Result<t> {
    private int code;
    private String message;
    private T data;
    private long timestamp;
    private String requestId;

    public static <t> Result<t> success(T data) {
        Result<t> r = new Result();
        r.code = 200;
        r.message = "success";
        r.data = data;
        r.timestamp = System.currentTimeMillis();
        return r;
    }

    public static <t> Result<t> error(int code, String message) {
        Result<t> r = new Result();
        r.code = code;
        r.message = message;
        r.timestamp = System.currentTimeMillis();
        return r;
    }
    // getter/setter 省略
}
</t></t></t></t></t></t></t>

用枚举统一管理错误码

避免硬编码数字和字符串，把错误码和提示封装进enum，自带描述、可序列化、IDE能补全、后期增删方便。

常见类型覆盖：成功（0）、参数错误（1001）、资源不存在（404）、权限不足（403）、系统繁忙（500）、业务冲突（如重复提交）等。

示例：

sc-java-to-ts-interface

将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。

下载

public enum ErrorCode {
    SUCCESS(0, "操作成功"),
    PARAM_ERROR(1001, "请求参数格式错误"),
    NOT_FOUND(404, "请求资源不存在"),
    FORBIDDEN(403, "无访问权限"),
    SYSTEM_ERROR(500, "系统繁忙，请稍后再试");

    private final int code;
    private final String message;

    ErrorCode(int code, String message) {
        this.code = code;
        this.message = message;
    }
    // getter 省略
}