Spring Boot(Kotlin)多Content-Type接口中application/json请求参数解析异常问题排查

我来帮你拆解下这个问题，你碰到的情况是Spring Boot处理不同Content-Type请求时的参数绑定逻辑差异导致的：

核心原因 #

当请求的Content-Type为application/x-www-form-urlencoded时，Spring会默认使用@ModelAttribute（隐式添加）来自动将表单参数绑定到NewUser对象上，所以参数能正常接收；但当Content-Type为application/json时，Spring需要明确通过@RequestBody注解告知框架：需要将请求体的JSON数据反序列化为指定的Java/Kotlin对象。你的代码里newUser参数没有添加这个注解，导致Spring无法正确解析JSON请求体，最终newUser.email始终为null，触发了你的非空校验逻辑。

快速修复方案 #

给newUser参数添加@RequestBody注解即可解决JSON请求的问题，修改后的接口代码如下：

@PostMapping( value = ["/users/new"], consumes = [ 
    MediaType.APPLICATION_JSON_VALUE, 
    MediaType.APPLICATION_XML_VALUE, 
    MediaType.MULTIPART_FORM_DATA_VALUE, 
    MediaType.APPLICATION_FORM_URLENCODED_VALUE
] )
fun registerNewUser( 
    @RequestHeader("X-Forward-For") ipAddress: String?, 
    @RequestBody newUser: NewUser, 
    request: HttpServletRequest 
): ResponseEntity<ObjectNode> {
    var realIPAddress = ipAddress
    if (realIPAddress == null) {
        realIPAddress = request.remoteAddr
    }
    return userService.registerUser(realIPAddress!!, newUser)
}

兼容多种Content-Type的注意事项 #

不过这里有个小坑：添加@RequestBody后，application/x-www-form-urlencoded格式的请求可能会失效，因为@RequestBody只能处理请求体为JSON/XML这类结构化格式的内容，无法直接解析表单参数。如果需要同时兼容多种格式，你可以选择以下两种方案：

• 拆分接口：分别定义支持JSON和表单格式的接口，比如一个接口用@RequestBody处理JSON/XML请求，另一个接口用@ModelAttribute处理表单请求，这样逻辑清晰且维护简单。
• 自定义参数解析逻辑：通过实现HandlerMethodArgumentResolver来创建自定义的参数解析器，根据请求的Content-Type自动选择绑定方式，不过这种方式相对复杂，适合有特殊需求的场景。

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