在 java 日志记录中，使用 aop（面向切面编程）统一记录日志的核心做法是定义一个自定义注解并配合 aspectj 实现环绕通知。具体而言，你需要创建一个如 @logexecution 的注解标记目标方法，然后在切面类中使用 @around 拦截这些方法，通过 proceedingjoinpoint 获取方法参数、执行结果及耗时，并利用 slf4j 或 logback 等日志框架将关键信息写入日志文件。这样做可以在不侵入业务代码的前提下，自动完成对指定方法的监控和审计。
如何定义用于标识日志记录的自定义注解
要启用统一的日志记录，第一步是定义一个元注解，用于标记需要被切面拦截的业务方法。这个注解通常包含一些可选属性，例如操作名称或日志级别，以便在日志输出时提供更具语义化的描述。开发者只需在 Controller 层或 Service 层的方法上添加该注解，AOP 机制即可识别并应用相应的日志逻辑。
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface SystemLog {
String value() default "";
}
上述代码定义了一个名为 SystemLog 的注解，它作用于方法级别且在运行时可见。在实际使用中，你可以在具体的业务方法上这样标注：@SystemLog("用户登录")。这为后续的切面处理提供了明确的切入点信号。接下来，我们需要编写切面类来实际捕获这些被标记的方法调用。
立即学习“Java免费学习笔记（深入）”；
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
如何通过环绕通知实现日志的具体收集与记录
定义了注解后，关键在于编写切面类来实现日志的收集。利用 @Aspect 和 @Component 将切面注册为 Spring Bean，并使用 @Around 注解绑定到之前定义的注解点上。在通知方法中，通过反射获取方法签名、参数以及执行前后的时间戳，计算耗时并将结构化数据传递给日志记录器。这种方式能够确保所有被标记的方法都被一致地处理，无论其内部逻辑如何复杂。
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.reflect.MethodSignature;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;
import java.lang.reflect.Method;
import java.util.Arrays;
@Aspect
@Component
public class LogAspect {
private static final Logger logger = LoggerFactory.getLogger(LogAspect.class);
@Around("@annotation(SystemLog)")
public Object recordLog(ProceedingJoinPoint joinPoint) throws Throwable {
long startTime = System.currentTimeMillis();
MethodSignature signature = (MethodSignature) joinPoint.getSignature();
Method method = signature.getMethod();
SystemLog systemLog = method.getAnnotation(SystemLog.class);
String methodName = joinPoint.getTarget().getClass().getName() + "." + method.getName();
String params = Arrays.toString(joinPoint.getArgs());
logger.info("开始执行方法: {}, 参数: {}", methodName, params);
Object result;
try {
result = joinPoint.proceed();
logger.info("方法执行成功: {}, 耗时: {}ms", methodName, System.currentTimeMillis() - startTime);
} catch (Exception e) {
logger.error("方法执行异常: {}, 错误信息: {}", methodName, e.getMessage());
throw e;
}
return result;
}
}
这段代码展示了完整的切面实现。它首先记录开始时间和参数，然后执行原方法 joinPoint.proceed()。如果执行成功，记录成功日志和耗时；如果发生异常，记录错误信息并重新抛出异常，以保证业务逻辑的事务完整性。这种模式确保了日志的一致性和可追溯性。
当业务方法抛出异常时日志记录会如何处理
在基于程序中某个输入、条件或结果的具体问题中，最值得关注的是异常场景下的日志行为。当被标记的方法在执行过程中抛出未捕获的异常时，切面的 @Around 通知中的 try-catch 块会捕获该异常。此时，日志记录器会输出错误级别的日志，包含方法名和异常堆栈信息，随后异常会被重新抛出，从而中断当前方法的正常返回流程。这意味着业务逻辑的中断会被完整记录，便于后续排查问题，而不会导致程序静默失败。
