SpringBoot升级至2.7.5后@PathVariable隐式参数名失效求助

问题现象 #

将SpringBoot版本从2.1.1升级至2.7.5后，部分应用间歇性出现请求解析错误：

{ "errorCode": "BAD_REQUEST", "description": "Name for argument of type [java.lang.String] not specified, and parameter name information not found in class file either." }

原本正常运行的隐式路径变量写法：

@GetMapping("/{caseId}/audit")
public List<AuditRecord> getCaseAuditRecords(@PathVariable String caseId) {
    // 业务逻辑
}

必须改为显式指定参数名才能正常运行：

@GetMapping("/{caseId}/audit")
public List<AuditRecord> getCaseAuditRecords(@PathVariable("caseId") String caseId) {
    // 业务逻辑
}

根因分析 #

这个问题的核心是Java字节码中是否保留了方法参数的原始名称：

• Spring MVC解析@PathVariable隐式参数名时，依赖从字节码中读取方法参数的真实名称。如果编译时没有添加-parameters参数，字节码中只会生成arg0、arg1这类占位符名称，Spring无法匹配路径中的{caseId}。
• SpringBoot 2.1.x版本默认的编译配置或MVC解析逻辑可能存在兼容处理，即使没有-parameters也能通过某些方式（比如调试信息）获取参数名；但2.7.x版本（属于2.6+分支）对MVC参数解析逻辑做了优化，移除了旧的兼容逻辑，导致未配置-parameters的环境直接触发错误。
• 间歇性出现的原因通常是不同环境的编译配置不一致：部分环境开启了-parameters，部分没有，导致问题时有时无。

解决方案 #

方案1：显式指定@PathVariable参数名 #

这是最稳定的解决方案，不受编译环境影响，直接在注解中明确参数名，就像你已经尝试的那样。

方案2：统一配置编译时保留参数名 #

确保所有编译环境都添加-parameters参数，让字节码保留原始参数名：

• Maven项目：在pom.xml的maven-compiler-plugin中配置：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.8.1</version>
      <configuration>
          <parameters>true</parameters>
          <source>1.8</source> <!-- 按需替换你的JDK版本 -->
          <target>1.8</target>
      </configuration>
  </plugin>
  

• Gradle项目：在build.gradle中配置：

  compileJava {
      options.parameters = true
  }
  

方案3：检查IDE编译配置 #

如果是本地开发环境出现问题，确保IDE的编译设置启用了参数名保留：

• IntelliJ IDEA：打开Settings > Build, Execution, Deployment > Compiler > Java Compiler，勾选Store information about method parameters (usable via reflection)选项。

同类问题反馈 #

不少升级到SpringBoot 2.6及以上版本的开发者都遇到过这个问题，大多是因为编译环境未配置-parameters导致的。Spring官方在2.6版本的MVC优化中，收紧了参数名解析的规则，不再兼容无-parameters的场景，这也是问题集中出现的原因。

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