SpringBoot 实战必备：AOP + ThreadLocal 核心知识点（附实战代码）

在 SpringBoot 项目开发中AOP面向切面编程和 ThreadLocal 是高频实用技术尤其在日志记录、用户上下文传递等场景中不可或缺。本文结合实际项目代码操作日志切面 登录用户ID存储整理两者核心知识点、实战场景及注意事项适合新手入门和开发者巩固复习。一、AOP 核心知识点实战重点版1. 什么是 AOPAOPAspect Oriented Programming面向切面编程核心是不修改原有业务代码通过“切面”对方法进行统一增强如日志、事务、权限校验实现“关注点分离”——业务代码只关注业务逻辑通用逻辑如日志抽离到切面中降低耦合。底层实现基于动态代理JDK 动态代理针对接口CGLIB 动态代理针对类无接口时使用SpringBoot 自动集成 AspectJ无需手动配置代理。2. 核心概念必背结合实战理解结合本文实战案例操作日志切面用通俗的语言解释 6 个核心概念拒绝晦涩连接点JoinPoint所有能被增强的方法比如你项目中 Controller 里的所有接口方法是“可能被拦截”的点。切入点Pointcut实际被拦截的方法通过表达式筛选。比如案例中Around(annotation(com.itymy.anno.Olog))就是筛选出所有加了Olog注解的方法。通知Advice增强的逻辑也是切面的核心代码。常用 5 种重点掌握环绕通知Before方法执行前执行如权限校验AfterReturning方法正常返回后执行如日志记录AfterThrowing方法抛异常后执行如异常日志After方法最终执行无论正常/异常如资源释放Around环绕方法执行最强大可控制方法执行前后、是否放行案例中就是用这个切面Aspect切入点 通知的组合就是一个完整的切面类如案例中的OperationLogAspect用Aspect注解声明。目标对象Target被拦截、被增强的原始业务对象如案例中被Olog注解标记的 Controller 方法所在的类。织入WeavingSpring 把切面代码嵌入到目标方法中的过程自动完成无需手动操作。3. 实战核心结合你的操作日志切面你的 AOP 切面是「操作日志自动记录」核心逻辑对应 AOP 知识点拆解如下// 1. 声明切面Aspect 交给Spring管理Component Slf4j Aspect Component public class OperationLogAspect { Autowired private OperateLogMapper operateLogMapper; // 2. 切入点筛选所有加了Olog注解的方法 Around(annotation(com.itymy.anno.Olog)) // 3. 环绕通知ProceedingJoinPoint 代表被拦截的目标方法 public Object around(ProceedingJoinPoint joinPoint) throws Throwable { long startTime System.currentTimeMillis(); // 4. 放行执行业务方法joinPoint.proceed()并获取返回值 Object result joinPoint.proceed(); long costTime System.currentTimeMillis() - startTime; // 5. 增强逻辑拼装日志、存入数据库 OperateLog operateLog new OperateLog(); operateLog.setOperateEmpId(CurrentHolder.getCurrentId()); // 从ThreadLocal获取用户ID operateLog.setOperateTime(LocalDateTime.now()); operateLog.setClassName(joinPoint.getTarget().getClass().getName()); // 目标类名 operateLog.setMethodName(joinPoint.getSignature().getName()); // 目标方法名 operateLog.setMethodParams(Arrays.toString(joinPoint.getArgs())); // 方法参数 operateLog.setReturnValue(result.toString()); // 方法返回值 operateLog.setCostTime(costTime); operateLogMapper.insert(operateLog); return result; // 必须返回目标方法的原始返回值保证接口正常响应 } }4. 关键注意事项避坑重点Around 环绕通知必须调用joinPoint.proceed()才能放行否则业务方法不会执行且必须返回目标方法的返回值如案例中的return result否则前端会接收不到响应。切入点表达式要精准避免误拦截如案例中用自定义注解只拦截需要记录日志的方法比拦截所有Controller方法更灵活。切面中如果有数据库操作、远程调用等耗时操作建议异步处理避免影响主业务接口的响应速度。SpringBoot 中无需手动添加EnableAspectJAutoProxy引入spring-boot-starter-aop依赖后自动开启 AOP 支持。二、ThreadLocal 核心知识点实战重点版1. 什么是 ThreadLocalThreadLocal 是 Java 提供的一种线程本地存储工具核心作用为每个线程维护一个独立的变量副本线程之间的变量互不干扰实现“线程安全”的变量共享仅当前线程可见。通俗理解每个线程都有一个“专属小盒子”ThreadLocal 就是这个盒子的管理者你可以往盒子里存数据、取数据其他线程看不到你盒子里的内容也不会修改你的数据。核心场景SpringBoot 中存储当前登录用户信息如用户ID在全项目中AOP、Service、Controller随时获取无需手动传参如你项目中的CurrentHolder工具类。2. 核心方法结合你的 CurrentHolder 工具类ThreadLocal 常用 3 个方法你的工具类全部用到对应如下public class CurrentHolder { // 1. 初始化 ThreadLocal指定存储类型这里是当前登录用户IDInteger类型 private static final ThreadLocalInteger CURRENT_LOCAL new ThreadLocal(); // 2. 存入数据登录校验成功后把用户ID存入ThreadLocal public static void setCurrentId(Integer employeeId) { CURRENT_LOCAL.set(employeeId); } // 3. 取出数据在AOP、Service等地方获取当前线程的用户ID public static Integer getCurrentId() { return CURRENT_LOCAL.get(); } // 4. 移除数据请求结束后必须删除防止内存泄漏 public static void remove() { CURRENT_LOCAL.remove(); } }补充说明 3 个核心方法的细节set(T value)给当前线程的 ThreadLocal 副本设置值仅当前线程可见。get()获取当前线程的 ThreadLocal 副本中的值若未设置返回 null。remove()删除当前线程的 ThreadLocal 副本中的值必须调用重点避坑。3. 实战场景和 AOP 联动你的项目中ThreadLocal 和 AOP 是完美联动的完整流程如下用户登录登录接口校验成功后调用CurrentHolder.setCurrentId(用户ID)把当前登录用户ID存入 ThreadLocal。接口请求用户访问加了Olog注解的接口AOP 切面拦截该方法。日志记录AOP 切面中调用CurrentHolder.getCurrentId()获取当前登录用户ID作为操作人存入日志。请求结束在拦截器的afterCompletion方法中调用CurrentHolder.remove()删除 ThreadLocal 中的数据防止内存泄漏。核心优势无需在每个接口、每个方法中手动传递用户ID通过 ThreadLocal 实现“全局共享、线程隔离”简化代码提高可维护性。4. 关键注意事项避坑重中之重内存泄漏问题最容易踩坑ThreadLocal 底层依赖 ThreadLocalMap若不调用remove()线程结束后如 Tomcat 线程池复用ThreadLocal 中的数据不会自动清理会导致内存泄漏。解决方案在请求结束后拦截器 afterCompletion、过滤器 doFilter 最后必须调用remove()。线程隔离性ThreadLocal 中的数据仅当前线程可见不同线程之间的数据互不干扰适合存储“线程私有”的数据如当前登录用户、请求ID等。静态修饰 ThreadLocal一般把 ThreadLocal 定义为 static 变量如你的 CurrentHolder避免每次创建对象时重复初始化保证全局只有一个 ThreadLocal 实例管理线程变量。null 处理调用get()时可能返回 null如未登录、未设置值需做非空判断避免空指针异常比如你的 AOP 中若用户未登录CurrentHolder.getCurrentId() 会返回 null存入数据库时需处理。三、AOP ThreadLocal 联动总结实战核心结合你的项目代码两者的联动是 SpringBoot 开发中的经典用法总结如下ThreadLocal 负责“存储”存储当前登录用户ID等全局共享、线程私有的数据供全项目随时获取。AOP 负责“增强”拦截指定方法通过 ThreadLocal 获取所需数据如用户ID实现通用逻辑如操作日志的统一增强不侵入业务代码。核心价值简化代码、降低耦合、提高可维护性比如你新增一个需要记录日志的接口只需加一个Olog注解无需修改接口代码AOP 会自动完成日志记录用户ID也会通过 ThreadLocal 自动获取。四、补充说明1. 依赖说明使用 AOP 需引入 SpringBoot AOP 依赖可带版本号避免依赖冲突dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-aop/artifactId version3.2.5/version !-- 对应SpringBoot 3.x JDK17按需调整 -- /dependency2. 自定义注解 Olog需配合 AOP 切入点使用代码如下完整度拉满Target(ElementType.METHOD) // 仅作用于方法 Retention(RetentionPolicy.RUNTIME) // 运行时生效 public interface Olog { String value() default ; // 可自定义日志描述如Olog(删除部门) }3. 适用场景除了操作日志AOP ThreadLocal 还可用于权限校验、接口耗时统计、数据脱敏、请求追踪等场景。结语AOP 和 ThreadLocal 是 SpringBoot 实战中不可或缺的两个工具掌握两者的核心知识点和联动用法能大幅提升开发效率减少冗余代码。本文结合实际项目代码拆解避开常见坑点适合新手入门和开发者复习收藏备用