2024-01-19
温故知新
00

目录

简介
原因分析
解决

简介

使用最新版的 Springboot 3.2.1 搭建开发环境进行开发,调用接口时出现奇怪的错。报错主要信息如下:

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 新版本导致的。为什么会出现这个问题呢?原来是 Spring 6.1 之后,官方加强了很多错误校验和报错提示,本文这个错也是其中之一。

Spring表示:URL中的传参,必须使用 @PathVariable 声明用于接收的变量,如:

java
@DeleteMapping("/employees/{employeeId}") public String deleteEmployee(@PathVariable int employeeId) { ... } @PatchMapping("/employees/{id}/{firstName}") public String patchEmployee(@PathVariable Integer id, @PathVariable String firstName) { ... }

官方说明中一直强调 @PathVariable 的使用,并没有提及 @RequestParam,参考官方文档@RequestParam 会发现最后有一句话:

Note that use of @RequestParam is optional (for example, to set its attributes). By default, any argument that is a simple value type (as determined by BeanUtils#isSimpleProperty) and is not resolved by any other argument resolver, is treated as if it were annotated with @RequestParam.

翻译一下大概是:

注意@RequestParam 的使用是可选的(例如,设置其属性)。 默认情况下,任何简单值类型(由 BeanUtils#isSimpleProperty 确定)且未由任何其他参数解析器解析的参数都将被视为使用 @RequestParam 注解。

根据原文及翻译,这自然让我认为,@RequestParam 依然是可以省略的。

然而奇怪的是,当 Springboot 3.2.1 使用Maven管理项目时,如果不使用 spring-boot-starter-parent 作为父工程,那么接口中必须显式声明 @RequestParam("name"),缺了其中的 name 也会报错。我清晰地记得我在旧版本的 Springboot 中经常省略 @RequestParam("name") 这种写法。

但如果不使用 spring-boot-starter-parent 作为父工程,好像 @RequestParam 变成了不可省略注解。大家搭建微服务和多模块时候,通常不会使用spring-boot-starter-parent作为父工程吧?还是只有我不用?。。。

  • 错误代码

当请求URL中有正常参数时,如:http://localhost:8080/user/hello?name=zhangsan,其中 name 为一个参数,你的 Controller代码大概如下所示:

java
@GetMapping("/hello") public RespPack<?> hello(String name) { return null; }
  • 主要 pom.xml
xml
<dependencyManagement> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-dependencies</artifactId> <version>${boot.version}</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies>

解决

这种现象不知道是不是官方的BUG,但目前我发现两种解决方案:

  1. 使用 @RequestParam("name")
java
// 在 name 参数前加上 @RequestParam("name") @GetMapping("/hello") public RespPack<?> hello(@RequestParam("name") String name) { return null; }
  1. 使用 spring-boot-starter-parent
xml
<!-- 将spring-boot-starter-parent作为父工程在pom.xml中引入 --> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.2.1</version> <relativePath/> </parent>

更信息可阅读我在 stackoverflow 中的提问:stackoverflow

后续如果有变动会随时同步该文章

赞助

建站不易,以下是一个广告,还请动动您的小拇指,点击一次以示鼓励,谢谢!

就目前的访问量,即便每个访客都点一次广告,收入也不足以支付运营成本,如果看不到广告,可能是网络原因或被拦截了,那就无所谓了~

如果对你有用的话,可以打赏哦
打赏
ali pay
wechat pay

本文作者:DingDangDog

本文链接:

版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!