Spring Boot AOP日志能否将日志类名替换为被代理类名？

你找对了核心思路——通过joinPoint.getTarget().getClass()获取被代理类的信息，接下来只需要把这个信息整合到日志输出逻辑里，就能替换掉默认显示的切面类名。下面分享两种实用的方案，适合不同的场景：

方案1：直接基于目标类创建Logger对象 #

这是最直接的方式：在切面的通知方法中，动态获取被代理类的Class对象，用它来创建对应的Logger实例，再通过这个Logger输出日志。这样日志框架就会自动输出目标类的全限定名，而不是切面类的。

示例代码如下：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.util.ClassUtils;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class MyAspectOrientedLogger {

    @Around("execution(* com.yourpackage.service.*.*(..))") // 替换成你的切点表达式
    public Object logMethodExecution(ProceedingJoinPoint joinPoint) throws Throwable {
        // 获取原始目标类（处理CGLIB/JDK代理的情况）
        Class<?> targetClass = ClassUtils.getUserClass(joinPoint.getTarget().getClass());
        // 基于目标类创建Logger
        Logger targetLogger = LoggerFactory.getLogger(targetClass);

        // 输出日志，此时日志的类名就是目标类（比如c.s.b.s.UserService）
        targetLogger.info("开始执行方法: {}", joinPoint.getSignature().getName());
        
        Object result = joinPoint.proceed();
        
        targetLogger.info("方法执行完成: {}", joinPoint.getSignature().getName());
        return result;
    }
}

注意事项： #

• 如果目标类是CGLIB动态代理生成的子类（类名带$$EnhancerBySpringCGLIB$$后缀），用Spring的ClassUtils.getUserClass()可以获取原始的目标类，避免日志里出现代理类的奇怪名称
• 如果是JDK动态代理，joinPoint.getTarget().getClass()直接返回真实的目标类，无需额外处理

方案2：用MDC传递目标类名，修改日志格式 #

如果你希望保持切面类的Logger实例不变，只是在日志格式中替换类名，可以借助SLF4J的MDC（映射诊断上下文）来实现。这种方式更灵活，不需要修改每一条日志语句，只需统一配置日志格式即可。

步骤1：在切面中把目标类名放入MDC #

import org.slf4j.MDC;
import org.springframework.util.ClassUtils;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class MyAspectOrientedLogger {

    private static final String TARGET_CLASS_NAME = "targetClassName";

    @Around("execution(* com.yourpackage.service.*.*(..))")
    public Object logMethodExecution(ProceedingJoinPoint joinPoint) throws Throwable {
        // 获取原始目标类
        Class<?> targetClass = ClassUtils.getUserClass(joinPoint.getTarget().getClass());
        // 将目标类名放入MDC
        MDC.put(TARGET_CLASS_NAME, targetClass.getName());
        
        try {
            return joinPoint.proceed();
        } finally {
            // 务必清理MDC，避免线程复用导致的脏数据
            MDC.remove(TARGET_CLASS_NAME);
        }
    }
}

步骤2：修改日志格式配置（以Logback为例） #

找到你的logback-spring.xml或logback.xml配置文件，修改控制台输出的pattern，把原来的%c（或%logger，代表日志所属类名）替换为%X{targetClassName:-%c}——这个表达式的意思是：如果MDC中存在targetClassName的值，就用它；否则 fallback到原来的类名。

示例配置：

<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %X{targetClassName:-%c} - %msg%n</pattern>
    </encoder>
</appender>

这样配置后，所有经过切面的日志都会显示被代理类的全限定名，未经过切面的日志则保持原来的类名输出，兼容性拉满。

内容的提问来源于stack exchange，提问作者Denis Stephanov