You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Spring WebFlux RestController报错:Required parameter is not present 求解决

解决Spring WebFlux Controller 400 Bad Request问题

嘿,我来帮你排查这个问题!你遇到的400错误是因为参数传递的方式和代码里的注解不匹配导致的,咱们一步步来解决:

问题原因分析

你的控制器方法用了@RequestParam("parameters")注解,这个注解的作用是从URL查询参数或者**表单提交的参数(content-type为application/x-www-form-urlencoded)**中获取值。如果你的Postman请求是用JSON格式(raw -> JSON)发送的,参数会被放在请求体里,Spring找不到对应的parameters参数,就会抛出"Required String parameter 'parameters' is not present"的错误。

解决方案

根据你的需求,有两种可行的解决方式:

方式一:继续使用@RequestParam,调整Postman请求方式

如果想保留当前的代码,只需要修改Postman的请求配置:

  • 选择form-data或者x-www-form-urlencoded选项卡,添加一个key为parameters的参数,填写对应的值,然后发送POST请求。
  • 或者直接把参数拼在请求URL后面,比如:POST http://localhost:8080/test2?parameters=your-test-value,这样@RequestParam也能正常捕获到参数。

方式二:改用JSON请求体传递参数(推荐用于Post请求)

如果希望用JSON格式传递参数,需要修改代码中的注解,并定义一个简单的DTO类来接收请求体:

  1. 定义请求DTO类:
public class RequestParamsDto {
    private String parameters;

    // Spring序列化需要无参构造器
    public RequestParamsDto() {}

    // Getter和Setter方法
    public String getParameters() {
        return parameters;
    }

    public void setParameters(String parameters) {
        this.parameters = parameters;
    }
}
  1. 修改控制器方法:
@RestController
public class Demo {
    @PostMapping(value = "test2")
    // 推荐返回Mono/Flux符合WebFlux非阻塞特性
    public Mono<Integer> getHashCode(@RequestBody RequestParamsDto requestDto) {
        return Mono.just(requestDto.getParameters().hashCode());
    }
}
  1. Postman配置:选择raw -> JSON,请求体填写:
{"parameters": "your-test-string"}

然后发送POST请求即可正常返回结果。

另外补充一点:虽然你的代码返回Integer也能运行,但Spring WebFlux更推荐使用响应式类型(Mono/Flux)作为返回值,这样能更好地发挥WebFlux的非阻塞优势哦。

内容的提问来源于stack exchange,提问作者Shuai Junlan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.27 03:47:07