Spring Boot请求体类型校验仅返回400，如何添加自定义错误提示？

问题根因 #

你遇到的400无提示问题，是因为请求JSON的字段类型和实体类不匹配时，Jackson反序列化步骤直接失败，请求还未走到@Valid触发的JSR参数校验逻辑，因此自定义校验注解不会生效，Spring直接返回默认的400空响应。
你目前把字段改为String加@Pattern的方案存在明显缺陷：破坏了实体类的类型安全性，后续业务逻辑需要额外做类型转换，字段较多时维护成本极高，不推荐使用。

推荐实现方案：全局异常捕获处理 #

通过Spring的全局异常处理器统一捕获反序列化失败异常，自动提取错误字段和期望类型，返回友好提示，无需修改原有实体类定义。

步骤1：引入参数校验依赖（如未引入） #

<!-- Maven 依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

步骤2：编写全局异常处理器 #

import com.fasterxml.jackson.databind.exc.InvalidFormatException;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.http.converter.HttpMessageNotReadableException;

import java.util.HashMap;
import java.util.Map;

@RestControllerAdvice
public class GlobalExceptionHandler {

    // 处理JSON类型转换失败的异常
    @ExceptionHandler(HttpMessageNotReadableException.class)
    public ResponseEntity<Map<String, String>> handleTypeConvertError(HttpMessageNotReadableException e) {
        Map<String, String> res = new HashMap<>();
        String errMsg = "请求参数格式错误";
        // 解析Jackson反序列化错误的具体字段和类型
        if (e.getCause() instanceof InvalidFormatException formatException) {
            String fieldName = formatException.getPath().get(0).getFieldName();
            String expectType = formatException.getTargetType().getSimpleName();
            errMsg = String.format("%s必须为%s类型", fieldName, expectType);
        }
        res.put("message", errMsg);
        return new ResponseEntity<>(res, HttpStatus.BAD_REQUEST);
    }

    // 处理@Valid触发的参数校验异常（比如@NotBlank校验失败）
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleParamCheckError(MethodArgumentNotValidException e) {
        Map<String, String> errors = new HashMap<>();
        for (FieldError fieldError : e.getBindingResult().getFieldErrors()) {
            errors.put(fieldError.getField(), fieldError.getDefaultMessage());
        }
        return new ResponseEntity<>(errors, HttpStatus.BAD_REQUEST);
    }
}

效果验证 #

发送你给出的测试请求：

{
  "name": "Foo Name",
  "age": "A String"
}

接口将返回状态码400，响应体为：

{
    "message": "age必须为Integer类型"
}

完全符合你需要的提示效果。

方案优势 #

• 无需修改原有实体类的字段类型，保持类型安全
• 所有接口的类型转换错误、参数校验错误都可以统一处理，不用为每个字段单独配置校验规则
• 扩展性强，后续需要新增其他异常的友好提示也可以直接在该类中添加

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