【SpringBoot】用一个常见错误说一下@RequestParam属性

问题

  • 在开发过程中,我们经常会用到 @RequestParam,我们常常会遇到另外一个问题。当需要特别多的请求参数时,我们往往会忽略其中一些参数是否可选。例如存在类似这样的代码:

    java 复制代码
    @RequestMapping(path = "/hi4", method = RequestMethod.GET)
    public String hi4(@RequestParam("name") String name, @RequestParam("address") String address){
        return name + ":" + address;
    };
  • 在访问 http://localhost:8080/hi4?name=xiaoming\&address=beijing 时并不会出问题,但是一旦用户仅仅使用 name 做请求(即 http://localhost:8080/hi4?name=xiaoming )时,则会直接报错如下:

  • 此时,返回错误码 400,提示请求格式错误:此处缺少 address 参数。

  • 实际上,部分初学者即使面对这个错误,也会觉得惊讶,既然不存在 address,address 应该设置为 null,而不应该是直接报错不是么?接下来我们就分析下。

问题解析

  • 要了解这个错误出现的根本原因,你就需要了解请求参数的发生位置。

  • 实际上,这里我们也能按注解名(@RequestParam)来确定解析发生的位置是在 RequestParamMethodArgumentResolver 中。为什么是它?

  • 追根溯源,针对当前案例,当根据 URL 匹配上要执行的方法是 hi4 后,要反射调用它,必须解析出方法参数 name 和 address 才可以。而它们被 @RequestParam 注解修饰,所以解析器借助 RequestParamMethodArgumentResolver 就成了很自然的事情。

  • 接下来我们看下 RequestParamMethodArgumentResolver 对参数解析的一些关键操作,参考其父类方法 AbstractNamedValueMethodArgumentResolver#resolveArgument:

    java 复制代码
    public final Object resolveArgument(MethodParameter parameter, @Nullable ModelAndViewContainer mavContainer,
          NativeWebRequest webRequest, @Nullable WebDataBinderFactory binderFactory) throws Exception {
       NamedValueInfo namedValueInfo = getNamedValueInfo(parameter);
       MethodParameter nestedParameter = parameter.nestedIfOptional();
       //省略其他非关键代码
       //获取请求参数
       Object arg = resolveName(resolvedName.toString(), nestedParameter, webRequest);
       if (arg == null) {
          if (namedValueInfo.defaultValue != null) {
             arg = resolveStringValue(namedValueInfo.defaultValue);
          }
          else if (namedValueInfo.required && !nestedParameter.isOptional()) {
             handleMissingValue(namedValueInfo.name, nestedParameter, webRequest);
          }
          arg = handleNullValue(namedValueInfo.name, arg, nestedParameter.getNestedParameterType());
       }
       //省略后续代码:类型转化等工作
       return arg;
    }
  • 如代码所示,当缺少请求参数的时候,通常我们会按照以下几个步骤进行处理。

1. 查看 namedValueInfo 的默认值,如果存在则使用它。
  • 这个变量实际是通过下面的方法来获取的,参考 RequestParamMethodArgumentResolver#createNamedValueInfo:

    java 复制代码
    @Override
    protected NamedValueInfo createNamedValueInfo(MethodParameter parameter) {
       RequestParam ann = parameter.getParameterAnnotation(RequestParam.class);
       return (ann != null ? new RequestParamNamedValueInfo(ann) : new RequestParamNamedValueInfo());
    }
  • 实际上就是 @RequestParam 的相关信息,我们调试下,就可以验证这个结论,具体如下图所示:

2. 在 @RequestParam 没有指明默认值时,会查看这个参数是否必须,如果必须,则按错误处理
  • 判断参数是否必须的代码即为下述关键代码行:

    java 复制代码
    namedValueInfo.required && !nestedParameter.isOptional()
  • 很明显,若要判定一个参数是否是必须的,需要同时满足两个条件:条件 1 是 @RequestParam 指明了必须(即属性 required 为 true,实际上它也是默认值),条件 2 是要求 @RequestParam 标记的参数本身不是可选的。

  • 我们可以通过 MethodParameter#isOptional 方法看下可选的具体含义:

    java 复制代码
    public boolean isOptional() {
       return (getParameterType() == Optional.class || hasNullableAnnotation() ||
             (KotlinDetector.isKotlinReflectPresent() &&
                   KotlinDetector.isKotlinType(getContainingClass()) &&
                   KotlinDelegate.isOptional(this)));
    }
  • 在不使用 Kotlin 的情况下,所谓可选,就是参数的类型为 Optional,或者任何标记了注解名为 Nullable 且 RetentionPolicy 为 RUNTIM 的注解。

3. 如果不是必须,则按 null 去做具体处理
  • 如果接受类型是 boolean,返回 false,如果是基本类型则直接报错,这里不做展开。

  • 结合我们的案例,我们的参数符合步骤 2 中判定为必选的条件,所以最终会执行方法 AbstractNamedValueMethodArgumentResolver#handleMissingValue:

    java 复制代码
    protected void handleMissingValue(String name, MethodParameter parameter) throws ServletException {
       throw new ServletRequestBindingException("Missing argument '" + name +
             "' for method parameter of type " + parameter.getNestedParameterType().getSimpleName());
    }

解决办法

  • 通过案例解析,我们很容易就能修正这个问题,就是让参数有默认值或为非可选即可,具体方法包含以下几种。
1. 设置 @RequestParam 的默认值
java 复制代码
@RequestParam(value = "address", defaultValue = "no address") String address
2. 设置 @RequestParam 的 required 值
java 复制代码
@RequestParam(value = "address", required = false) String address)
3. 标记任何名为 Nullable 且 RetentionPolicy 为 RUNTIME 的注解
java 复制代码
//org.springframework.lang.Nullable 可以
//edu.umd.cs.findbugs.annotations.Nullable 可以
@RequestParam(value = "address") @Nullable String address
4. 修改参数类型为 Optional
java 复制代码
@RequestParam(value = "address") Optional address
  • 从这些修正方法不难看出:假设你不学习源码,解决方法就可能只局限于一两种,但是深入源码后,解决方法就变得格外多了。这里要特别强调的是:在 Spring Web 中,默认情况下,请求参数是必选项。
相关推荐
时间之城1 分钟前
笔记:记一次使用EasyExcel重写convertToExcelData方法无法读取@ExcelDictFormat注解的问题(已解决)
java·spring boot·笔记·spring·excel
椰羊~王小美8 分钟前
LeetCode -- Flora -- edit 2025-04-25
java·开发语言
凯酱16 分钟前
MyBatis-Plus分页插件的使用
java·tomcat·mybatis
程序员总部26 分钟前
如何在IDEA中高效使用Test注解进行单元测试?
java·单元测试·intellij-idea
oioihoii29 分钟前
C++23中if consteval / if not consteval (P1938R3) 详解
java·数据库·c++23
佳腾_36 分钟前
【Web应用服务器_Tomcat】一、Tomcat基础与核心功能详解
java·前端·中间件·tomcat·web应用服务器
追逐时光者40 分钟前
MongoDB从入门到实战之Docker快速安装MongoDB
后端·mongodb
方圆想当图灵1 小时前
深入理解 AOP:使用 AspectJ 实现对 Maven 依赖中 Jar 包类的织入
后端·maven
豌豆花下猫1 小时前
Python 潮流周刊#99:如何在生产环境中运行 Python?(摘要)
后端·python·ai
嘻嘻嘻嘻嘻嘻ys1 小时前
《Spring Boot 3 + Java 17:响应式云原生架构深度实践与范式革新》
前端·后端