Spring Boot 3.2.4升级后@PathVariable参数反射获取名称失败求助

问题重现 #

将Spring Boot版本升级至3.2.4后，调用如下接口时触发报错：

@PutMapping("/{uid}/test/{state}")
@ResponseStatus(HttpStatus.NO_CONTENT)
public void update(
        Context context,
        @PathVariable String uid,
        @PathVariable String state
) throws RuntimeFunctionalException {
    this.service.updateState(uid, state, context);
}

报错信息：

Name for argument of type [java.lang.String] not specified, and parameter name information not available via reflection. Ensure that the compiler uses the '-parameters' flag

不少开发者都遇到过这个问题，核心原因是Spring无法通过反射获取方法参数的真实名称，导致无法匹配URL路径中的@PathVariable占位符。

解决方案 #

• 显式指定@PathVariable的参数名称
  直接在注解内声明对应占位符的名称，无需依赖反射获取参数名，这是最直接的修复方式：

  @PutMapping("/{uid}/test/{state}")
  @ResponseStatus(HttpStatus.NO_CONTENT)
  public void update(
          Context context,
          @PathVariable("uid") String uid,
          @PathVariable("state") String state
  ) throws RuntimeFunctionalException {
      this.service.updateState(uid, state, context);
  }
  

• 配置编译时添加-parameters参数
  如果希望保留隐式参数名匹配的写法，需要确保Java编译时带上-parameters参数，让类文件保留参数名称的元数据：

  • Maven配置：在pom.xml的maven-compiler-plugin中添加参数

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

  • Gradle配置：在build.gradle中添加编译参数

    tasks.withType(JavaCompile) {
        options.compilerArgs << "-parameters"
    }
    

升级后触发问题的原因 #

Spring Boot 3.x基于Spring Framework 6.x，对参数名称的获取逻辑做了更严格的校验。旧版本中可能会通过字节码工具（如ASM）尝试解析参数名作为兼容 fallback，但新版本移除了该逻辑，强制要求要么显式指定参数名，要么通过-parameters编译参数保留参数信息。

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