通义灵码实现Spring AOP日志记录切面编程指南

利用通义灵码生成AOP日志切面，前提是Spring项目的基础配置必须准确无误。依赖需引入spring-boot-starter-aop，配置类标注@EnableAspectJAutoProxy；切面类同时加上@Aspect和@Component；切入点表达式的包路径务必精确，否则切面静默失效且无任何报错；环绕通知中必须调用proceed()；日志级别设为DEBUG，使用log.debug()输出，参数判空避免NPE。下面逐步拆解。

首先确认项目已引入spring-boot-starter-aop，并在配置类（如@SpringBootApplication入口类）上添加@EnableAspectJAutoProxy。缺少该注解，通义灵码生成的切面类不会被Spring容器识别，更无法织入目标方法。这一配置是切面生效的开关，新手常因遗漏此处导致切面完全不执行。

定义AOP日志切面类

在src/main/java对应包下创建LogAspect.java，标注@Aspect和@Component，声明该类为Spring管理的切面组件。接着定义切入点，专门拦截@Service层的所有方法：

@Pointcut("execution(* com.example.demo.service..*.*(..))")

注意：这里的包路径com.example.demo.service仅为示例，务必替换为项目实际的service包名。包名错误会导致切面完全不触发，且无任何报错提示——这是最常见的隐蔽错误。建议编写后立即运行测试验证切入点生效。

编写环绕通知实现日志记录

实现方案有两种，各有利弊，按需选择。

方案一：使用@Around统一处理

在切面类中添加带@Around("logPointcut()")的方法，参数类型为ProceedingJoinPoint。调用proceed()前记录开始时间与方法签名，调用后捕获返回值或异常，计算耗时并输出结果。核心要点：必须显式调用joinPoint.proceed()，否则目标方法不会执行——这是环绕通知与前置/后置通知的本质区别。遗漏该调用会导致业务逻辑被静默跳过。

方案二：拆分为@Before+@AfterReturning+@AfterThrowing组合

若觉得环绕通知中try-catch嵌套影响可读性，可拆分成三个独立通知。@Before记录方法进入日志，@AfterReturning获取返回值并打印，@AfterThrowing捕获异常并输出堆栈。三者协同可避免单一方法内过多的异常处理分支，代码更清晰。

配置日志级别与输出格式

第一步：在application.yml（或application.properties）中单独设置切面所在包的日志级别为DEBUG，否则默认INFO级别将屏蔽log.debug()输出。示例：

logging.level.com.example.demo.aspect=DEBUG

第二步：在通知方法中，推荐使用Lombok的@Slf4j或手动声明Logger，采用log.debug()输出方法参数，而非log.info()。这样生产环境可通过配置平滑关闭，避免敏感信息泄露。

第三步：输出参数前务必判空。尤其集合类型或长字符串，直接调用toString()可能引发空指针，或大对象序列化拖慢接口响应。使用三目运算符或Objects.toString(arg, "null")即可快速处理。这些小细节直接决定系统稳定性与性能，不可轻视。

来源：互联网