Spring MVC无name属性的RequestParam在Native Image中失效问题

环境信息 #

• Spring Boot 3.1.3
• graalvm-jdk-17.0.8+9.1
• native-maven-plugin 0.9.5

问题描述 #

Controller中使用未显式指定name属性的@RequestParam时抛出IllegalArgumentException，提示无法找到参数名称信息；但显式指定name属性后可正常运行。

异常代码示例：

@GetMapping(value="/test", produces=MediaType.TEXT_PLAIN_VALUE)
public String test(@RequestParam(required=false) String category)

正常运行代码示例：

@GetMapping(value="/test", produces=MediaType.TEXT_PLAIN_VALUE)
public String test(@RequestParam(name = "category", required=false) String category)

异常栈 #

java.lang.IllegalArgumentException: Name for argument of type
[java.lang.String] not specified, and parameter name information not found in class file either.
at org.springframework.web.method.annotation.AbstractNamedValueMethodArgumentResolver.updateNamedValueInfo(AbstractNamedValueMethodArgumentResolver.java:177)
at org.springframework.web.method.annotation.AbstractNamedValueMethodArgumentResolver.getNamedValueInfo(AbstractNamedValueMethodArgumentResolver.java:154)
at org.springframework.web.method.annotation.AbstractNamedValueMethodArgumentResolver.resolveArgument(AbstractNamedValueMethodArgumentResolver.java:99)

项目配置说明 #

未使用Spring Boot父pom，通过导入依赖管理控制版本：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-dependencies</artifactId>
    <version>3.1.3</version>
    <type>pom</type>
    <scope>import</scope>
</dependency>

Native Image构建插件配置：

<plugin>
    <groupId>org.graalvm.buildtools</groupId>
    <artifactId>native-maven-plugin</artifactId>
    <configuration>
        <fallback>false</fallback>
        <verbose>true</verbose>
        <quickBuild>true</quickBuild>
        <metadataRepository>
            <enabled>true</enabled>
        </metadataRepository>       
        <jvmArgs>
            <jvmArg>-XX:+UseContainerSupport</jvmArg>
            <jvmArg>-XX:MaxRAMPercentage=70</jvmArg>                                
        </jvmArgs>                          
        <buildArgs>
            <arg>-H:+ReportExceptionStackTraces</arg>
            <!-- 临时规避GraalVM容器支持问题 -->
            <arg>-H:-UseContainerSupport</arg>
            <!-- 自定义反射元数据 -->
            <arg>-H:ReflectionConfigurationResources=META-INF/native-image/reflect-config.json</arg>
        </buildArgs>                            
        <requiredVersion>22.3</requiredVersion>
    </configuration>
    <executions>
        <execution>
            <id>add-reachability-metadata</id>
            <goals>
                <goal>add-reachability-metadata</goal>
            </goals>
        </execution>
    </executions>
</plugin>   

对比验证 #

将相同代码添加到官方Spring Native Image Demo中可正常运行，排除代码本身问题，定位为项目配置异常。

解决方案 #

1. 强制编译时保留参数名称 #

Spring依赖class文件中的参数名称信息解析未指定name的@RequestParam，需确保Maven编译插件启用-parameters参数：

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

2. 完善Native Image元数据生成 #

• 关闭quickBuild：快速构建模式会跳过部分元数据生成，设置<quickBuild>false</quickBuild>以生成完整元数据
• 确保引入Spring Boot Native Starter依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-native</artifactId>
</dependency>

3. 手动补充反射元数据 #

如果自动生成的元数据缺失，可在META-INF/native-image/reflect-config.json中手动添加Controller方法的参数名称：

[
  {
    "name": "com.your.package.YourTestController",
    "methods": [
      {
        "name": "test",
        "parameterTypes": ["java.lang.String"],
        "parameterNames": ["category"]
      }
    ]
  }
]

4. 校验依赖版本一致性 #

使用mvn dependency:tree检查所有依赖版本，确保Spring Native相关组件与Spring Boot 3.1.3版本完全兼容，避免版本冲突导致的元数据生成异常。

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