升级Spring Boot3.2.0+Java21后REST API参数名称缺失报错求助

核心原因 #

这个问题是编译时未将方法参数名称写入字节码，结合Spring Boot 3.2.x依赖的Spring Framework 6.1.x的参数名处理逻辑变化导致的：

• Spring Framework 6.1.x对参数名称的获取逻辑更严格，依赖字节码中MethodParameters属性（需编译时通过-parameters选项生成）；
• Spring Boot 3.1.x依赖的Spring Framework 6.0.x存在 fallback 机制，即使没有MethodParameters，也能通过局部变量表等方式推断参数名；
• Java 21下，若编译时未显式开启-parameters选项，字节码中不会保留参数名称信息，触发Spring的参数名缺失报错。

解决方案 #

确保Maven编译时开启-parameters选项，有两种配置方式：

方式1：直接配置Maven编译插件 #

在pom.xml中添加或修改maven-compiler-plugin配置：

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

方式2：通过Spring Boot Maven插件继承配置 #

如果使用Spring Boot的父依赖，Spring Boot Maven插件默认会开启parameters选项，但如果自定义了编译配置，需确保未覆盖该设置：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <!-- 确保未关闭parameters，默认是true -->
                <parameters>true</parameters>
            </configuration>
        </plugin>
    </plugins>
</build>

关于是否是Spring Boot的问题 #

这并非Spring Boot的bug，而是版本升级带来的兼容性调整：Spring Boot 3.2.x跟进了Spring Framework 6.1.x的参数名处理规范，要求编译时显式保留参数名称，目的是提升性能和规范一致性。之前的版本因兼容旧逻辑未强制要求，升级后需调整编译配置适配新规范。

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