Spring Boot Aspect无法获取Spring Data JPA Repository方法参数名

这个问题我之前也碰到过，核心原因是Spring Data JPA Repository的动态代理特性导致参数名丢失，咱们一步步来解决：

为什么Repository层拿不到参数名？ #

• Spring Data JPA的Repository默认通过JDK动态代理生成（基于接口），这种代理类不会保留原始方法的参数名元数据
• 即便你编译时开启了参数名保留，JDK代理生成的类也不会传递这些信息
• 你看到的com.sun.proxy.$Proxy436就是JDK动态代理生成的类，它的方法签名里完全没有参数名相关数据

具体解决方案 #

1. 确保编译时保留参数名 #

首先要保证项目编译时启用-parameters选项，让Java把方法参数名保留在字节码中，这是获取参数名的基础：

Maven配置（pom.xml）

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <compilerArgs>
                    <arg>-parameters</arg>
                </compilerArgs>
            </configuration>
        </plugin>
    </plugins>
</build>

Gradle配置（build.gradle）

compileJava {
    options.compilerArgs << '-parameters'
}

2. 切换Spring代理方式为CGLIB #

把默认的JDK动态代理改成CGLIB（基于类的代理），这样代理类会保留原始类的方法元数据：

在application.properties中添加：

spring.aop.proxy-target-class=true

或者application.yml：

spring:
  aop:
    proxy-target-class: true

3. 优化AspectJ切面逻辑 #

修改你的MethodLogger，处理代理类的情况，用Spring工具类更可靠地获取参数名：

@Component
@Aspect
public class MethodLogger {
    private final DiagnosticLogger logger = DiagnosticLogger.getLogger(getClass());
    private final ParameterNameDiscoverer parameterNameDiscoverer = new DefaultParameterNameDiscoverer();

    @Before("execution(* com.xyz..*.*(..))")
    public void beforeMethod(JoinPoint joinPoint) throws Throwable {
        // 跳过代理类，获取真实目标类
        Class<?> targetClass = AopProxyUtils.ultimateTargetClass(joinPoint.getTarget());
        System.out.println("Class******" + targetClass.getName());

        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        System.out.println("Method******" + signature.getName());

        // 获取真实的方法对象（处理接口代理的情况）
        Method method = signature.getMethod();
        if (method.getDeclaringClass().isInterface()) {
            method = targetClass.getDeclaredMethod(signature.getName(), method.getParameterTypes());
        }

        // 可靠获取参数名
        String[] parameterNames = parameterNameDiscoverer.getParameterNames(method);
        Object[] args = joinPoint.getArgs();

        if (parameterNames != null) {
            for (int i = 0; i < parameterNames.length; i++) {
                System.out.println("parameterNames******" + parameterNames[i] + ":" + args[i]);
            }
        }
    }
}

4. 验证切点范围 #

确保你的切面切点execution(* com.xyz..*.*(..))覆盖了Repository所在的包，如果Repository在特殊路径下，可以调整切点表达式，比如专门匹配Repository接口：

@Before("execution(* com.xyz..*Repository.*(..))")

原理说明 #

• CGLIB代理通过继承目标类生成代理，会完整保留原始类的方法元数据（包括参数名，前提是编译时开启了-parameters）
• AopProxyUtils.ultimateTargetClass能跳过多层代理，直接拿到Spring Data JPA生成的Repository真实实现类
• DefaultParameterNameDiscoverer是Spring提供的兼容工具，能同时处理编译时参数名和老版本debug信息中的参数名

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