技能介绍

要解决的问题

很多 SpringBoot 项目里，接口响应格式、异常返回、请求链路日志和用户上下文分散在各 Controller 和 Service 中，容易出现字段不一致、异常吞没、日志缺 requestId 等问题。这个技能把这些问题收敛为可复用的通用组件，适合在已有 springboot-init 生成的项目基础上补齐工程骨架。

组件如何工作

它围绕 Result、GlobalExceptionHandler、UserContext、ShowLogAspect 和 ResultAdvice 生成代码：

统一响应：生成 Result、ResultCode 和 RequestUtils，让接口返回带 requestId 的标准结构。
异常处理：生成 BizException 和 GlobalExceptionHandler，把业务异常统一转成失败响应。
用户上下文：通过 UserContextInterceptor 读取 x-user-id 和 x-request-id，并用 ThreadLocal 存储，方便日志和业务代码取用。
AOP 日志：@ShowLog 注解配合 ShowLogAspect 打印入参、返回值、耗时和异常标记。
依赖管理：更新 pom.xml，按 SpringBoot 版本选择 javax.servlet 或 jakarta.servlet，处理 Lombok、Fastjson2、Commons 等依赖。

适用边界

该技能依赖 springboot-init 生成的基础项目结构，参数里必须提供 artifactId 和 packageName 才能定位项目并生成包路径。它更适合补齐通用组件，而不是替代项目初始化、认证授权或复杂监控体系。若现有项目已有统一响应或拦截器，直接套用可能会产生重复类，需要手动核对包名、配置类和响应处理逻辑。