Spring RequestMapping无法区分RequestParam与RequestBody的问题求助

为什么移除@ModelAttribute会触发415错误？ #

Spring 中，@RequestBody 的作用是通过 HttpMessageConverter 把请求体内容转换成 Java 对象，但默认情况下，Spring 的转换器列表里没有专门处理 application/x-www-form-urlencoded 类型的规则——这种表单编码格式，Spring 原本是用 @ModelAttribute 或 @RequestParam 来解析的，它们会自动从请求体（x-www-form-urlencoded）或 URL 参数（querystring）中提取参数并绑定到对象/变量上。

当你移除 @ModelAttribute 后，@RequestBody SigninRequest sr 会要求 Spring 用 RequestBody 的逻辑解析请求体，但请求的 Content-Type 是 x-www-form-urlencoded，找不到匹配的转换器，就会抛出 415 Unsupported Media Type 异常。

解决方案（两种思路） #

思路1：拆分两个独立的POST接口 #

直接定义两个接口，通过 consumes 属性和注解区分请求类型，逻辑更清晰：

仅处理querystring的POST接口

import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;

@PostMapping(value = "/api/signin", consumes = MediaType.ALL_VALUE)
ResponseEntity<SigninResponse> signinWithQueryParams(
        @RequestParam(required = true) String username,
        @RequestParam(required = true) String password) {
    // 仅处理URL带querystring的POST请求
    return ResponseEntity.ok(new SigninResponse());
}

仅处理x-www-form-urlencoded的POST接口

import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.PostMapping;

@PostMapping(value = "/api/signin", consumes = MediaType.APPLICATION_FORM_URLENCODED_VALUE)
ResponseEntity<SigninResponse> signinWithFormBody(
        @ModelAttribute SigninRequest sr) {
    // 仅处理请求体为x-www-form-urlencoded的POST请求
    return ResponseEntity.ok(new SigninResponse());
}

Spring 会根据请求的 Content-Type 和参数注解自动匹配对应接口，你可以在各自方法里实现拒绝/允许逻辑。

思路2：在单个接口内判断并控制 #

如果想保留单个接口，可以通过 HttpServletRequest 直接判断数据来源：

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;

import javax.servlet.http.HttpServletRequest;

@PostMapping(value = "/api/signin")
ResponseEntity<SigninResponse> signin(
        HttpServletRequest request,
        @RequestParam(required = false) String username,
        @RequestParam(required = false) String password,
        @ModelAttribute(required = false) SigninRequest sr) {

    // 判断是否存在x-www-form-urlencoded请求体
    boolean hasFormBody = "application/x-www-form-urlencoded".equals(request.getContentType()) 
            && request.getContentLength() > 0;
    // 判断是否存在querystring参数
    boolean hasQueryParams = request.getQueryString() != null && !request.getQueryString().isEmpty();

    // 自定义逻辑：比如拒绝同时传两种参数的请求
    if (hasFormBody && hasQueryParams) {
        return ResponseEntity.badRequest().build();
    }
    // 仅允许表单请求体的情况
    if (hasFormBody) {
        return ResponseEntity.ok(new SigninResponse());
    }
    // 仅允许querystring的情况
    else if (hasQueryParams) {
        return ResponseEntity.ok(new SigninResponse());
    }
    // 无参数的情况
    else {
        return ResponseEntity.badRequest().build();
    }
}

这里不要用 @RequestBody，避免干扰表单参数的自动绑定，通过原生请求对象判断来源后再执行对应逻辑。

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