核心是用泛型wrapper类统一响应结构，支持动态状态码、枚举/整数+字符串构造、泛型静态工厂方法及builder模式；controller通过条件分支返回不同状态；全局异常处理器联动业务异常码；responsebodyadvice自动包装并支持注解或类型跳过。
核心思路是：用泛型 Wrapper 类定义统一结构，再通过流程控制（如条件判断、异常捕获、拦截器逻辑）决定返回哪种状态码和数据，而不是硬编码固定值。
泛型 Wrapper 类必须支持类型推导与灵活构造
Wrapper 类不能只提供 Result<t>.success(data)</t> 这种单一定式。它需要支持：
- 动态指定任意业务状态码（如 401、403、2001、5002），不绑定 HTTP 状态码
- 允许传入枚举类（如
ResultCodeEnum.LOGIN_AUTH）或整数+字符串组合 - 所有静态工厂方法都声明为泛型方法：
public static <t> Result<t> of(Integer code, String msg, T data)</t></t>，避免Result<object></object>与Result<user></user>类型不兼容 - 提供无参构造 + builder 模式，便于在复杂流程中分步赋值（例如先设 code/msg，后 set data）
在 Controller 层用 if-else 或 switch 控制返回分支
不是所有接口都“非成功即失败”。真实业务常有中间态，比如“审核中”“需二次验证”“库存预警”，这些都需要不同状态码和提示信息：
- 根据业务规则判断结果类型，再调用对应 Wrapper 构造方式
- 示例：
if (user.isLocked()) {
return Result.fail(217, "账号已停用");
} else if (!user.isActive()) {
return Result.fail(218, "请先完成实名认证");
} else {
return Result.success(user);
} - 避免在 Controller 内拼接 JSON 字符串或 new HashMap，所有响应都走 Wrapper
用全局异常处理器 + 自定义异常联动状态码
流程控制不仅体现在正常路径，更关键的是异常路径的标准化装配：
- 定义业务异常类（如
UserNotFoundException、InsufficientBalanceException），每个异常关联唯一业务码和默认提示 - 在
@ControllerAdvice中捕获这些异常，统一转为Result.fail(ex.getCode(), ex.getMsg()) - 系统级异常（如空指针、SQL 异常）兜底为 500，并记录日志，不暴露堆栈给前端
- 这样，Controller 方法体可专注主逻辑，异常分支由外部流程接管，状态码装配完全解耦
借助 ResponseBodyAdvice 实现自动注入与条件跳过
对大多数接口，希望“写啥返回啥，自动包一层”，但某些场景要绕过封装（如文件下载、第三方回调通知）：
- 实现
ResponseBodyAdvice，重写beforeBodyWrite() - 在方法上加自定义注解（如
@SkipWrapper），拦截时检查该注解，命中则直接返回原对象 - 也可按返回类型跳过：若返回
ResponseEntity、StreamingResponseBody、Void，不包装 - 这样，流程控制从代码层下沉到框架层，既统一又保留灵活性
