Spring Boot3+Java17迁移：AspectJAdviceParameterNameDiscoverer无法识别切面参数

问题背景 #

将应用从Spring Boot 2.2.1迁移至3.2.1，同步升级Java版本到17后，原有正常运行的切面在调用maybeBindThisOrTargetOrArgsFromPointcutExpression绑定参数时抛出AmbiguousBindingException。已开启maven-compiler-plugin的<parameters>true</parameters>配置，问题仍未解决。已知新版本Spring Boot不再支持LocalVariableTableParameterNameDiscoverer，原版本依赖该类识别参数，当前使用aspectjweaver 1.9.8版本。

相关配置与代码 #

Maven编译插件配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <parameters>true</parameters>
    </configuration>
</plugin>

切面代码：

@Aspect
@Component
public class TestAspect {

    private static final Logger logger = LoggerFactory.getLogger(TestAspect.class);
    private final TestExceptionHandler testExceptionHandler;

    public TestAspect(@Autowired TestExceptionHandler testExceptionHandler) {
        this.testExceptionHandler = testExceptionHandler;
    }

    @Around("execution(* com.csharma.test.practise.TestGenericProcess.execute(..)) && target(process) && args(context)")
    public void afterThrow(ProceedingJoinPoint joinPoint, TestGenericProcess process, Context context) throws Throwable {
        try {
            joinPoint.proceed();
        } catch (Throwable var5) {
            // 异常处理逻辑
        }
    }
}

原因分析 #

1. Spring 6参数识别机制变更：Spring Boot 3基于Spring 6构建，移除了旧版依赖的LocalVariableTableParameterNameDiscoverer，默认改用AspectJAdviceParameterNameDiscoverer处理切面参数名称识别。旧版本aspectjweaver（如1.9.8）的字节码处理逻辑与Spring 6的新机制存在兼容性冲突，导致参数匹配失败。
2. 绑定歧义触发异常：即使pointcut变量名与方法参数名表面一致，由于参数元数据读取方式改变，Spring AOP无法明确关联target(process)、args(context)与切面方法的参数，从而抛出AmbiguousBindingException。

解决方案 #

1. 升级aspectjweaver兼容版本 #

将aspectjweaver升级至与Spring Boot 3.2.1适配的版本（推荐1.9.21或更高），旧版本无法适配Java 17和Spring 6的新特性。

2. 显式指定参数绑定关系 #

在切面方法的参数上添加@org.springframework.aop.aspectj.annotation.Binding注解，明确关联pointcut中定义的变量名，消除绑定歧义。修改后的切面代码如下：

@Around("execution(* com.csharma.test.practise.TestGenericProcess.execute(..)) && target(process) && args(context)")
public void afterThrow(ProceedingJoinPoint joinPoint, 
                       @Binding("process") TestGenericProcess process, 
                       @Binding("context") Context context) throws Throwable {
    try {
        joinPoint.proceed();
    } catch (Throwable var5) {
        // 异常处理逻辑
    }
}

3. 完善Maven编译配置 #

确保maven-compiler-plugin明确指定Java 17的编译级别，避免因版本不一致导致的参数元数据缺失：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>17</source>
        <target>17</target>
        <parameters>true</parameters>
    </configuration>
</plugin>

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