统一响应封装需包含code、message、data三部分，支持泛型与静态工厂方法；区分HTTP状态与业务code；保障空值安全并提供isSuccess()判断。
在Java后端开发中，统一的响应结果封装是接口设计的基本规范。它能屏蔽底层异常细节、标准化状态码、简化前端解析逻辑，并提升团队协作效率。
定义通用返回结构体
一个典型的通用返回类应包含状态码、消息、数据三部分，支持泛型以适配不同业务实体：
- 使用int code表示HTTP或自定义业务状态（如200成功、500系统错误、400参数异常）
- String message提供可读提示，避免直接暴露堆栈或敏感信息
- T data为泛型字段，兼容对象、列表、空值等任意类型返回
- 提供静态工厂方法（如success()、fail(int, String)）快速构造实例
区分HTTP状态与业务状态
不要将Spring MVC的HTTP状态码（如HttpStatus.OK）直接映射为业务code。建议分层处理：
- Controller层统一返回ResponseEntity
> ，由全局异常处理器决定HTTP状态 - Result内部code专注业务语义：10000表示“操作成功”，10001表示“用户不存在”，20001表示“库存不足”
- 前端通过code判断业务分支，通过HTTP状态识别网络或服务级问题（如503 Service Unavailable）
支持空值安全与链式构建
避免data字段为null导致前端JSON解析异常或NPE风险：
立即学习“Java免费学习笔记（深入）”；
- 默认data初始化为null，但提供of(T data)和empty()明确语义
- 添加isSuccess()便捷方法，基于code范围判断（如code >= 10000 && code
- 构造器私有，强制通过静态方法创建，便于未来扩展日志埋点或审计字段
配合全局异常处理器统一兜底
Result类本身不处理异常，需搭配@ControllerAdvice实现自动封装：
- 捕获RuntimeException，返回Result.fail(500, "系统繁忙")
- 对IllegalArgumentException等参数异常，转为Result.fail(400, e.getMessage())
- 避免在每个Controller里手动try-catch，保持业务代码干净
不复杂但容易忽略。关键是把code定义清楚、data保持类型安全、异常流转不泄露细节。
