Spring Boot中@Valid校验信息未返回至Postman响应的问题

在Spring Boot项目中使用javax.validation做参数校验，校验逻辑已经生效（校验失败时控制台会输出ConstraintViolationException错误信息），但Postman收到的响应只有500内部服务器错误，没有具体的校验提示信息。

相关代码及信息 #

1. 实体类代码 #

@Lob
@Type(type = "org.hibernate.type.TextType")
@NotNull
@NotEmpty
@Column(name = "nome")
private String nome;

2. Controller的POST接口代码 #

@PostMapping(value = "/templates", produces = MediaType.APPLICATION_JSON_VALUE)
@ApiModelProperty("Cria um novo template")
public ResponseEntity<TemplateDTO> cadastraTemplate(@RequestBody @Valid TemplateDTO templateDTO, UriComponentsBuilder uriComponentsBuilder) {
        Template template = Template.desconvertId(templateDTO);
        templateRepository.save(template);
        URI uri = uriComponentsBuilder.path("template/{id}").buildAndExpand(template.getId()).toUri();
        return ResponseEntity.created(uri).body(new TemplateDTO(template));
    }

3. 控制台错误信息 #

2022-08-24 15:44:13.285 ERROR 1668 --- [nio-8080-exec-1] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is javax.validation.ConstraintViolationException: Validation failed for classes [com.ages.joinfut.Model.Template] during persist time for groups [javax.validation.groups.Default, ]
List of constraint violations:[
    ConstraintViolationImpl{interpolatedMessage='não deve estar vazio', propertyPath=nome, rootBeanClass=class com.ages.joinfut.Model.Template, messageTemplate='{javax.validation.constraints.NotEmpty.message}'}
]] with root cause

4. Postman响应内容 #

{
    "timestamp": "2022-08-24T18:44:13.302+00:00",
    "status": 500,
    "error": "Internal Server Error",
    "path": "/example/templates"
}

原因及解决方案 #

核心原因 #

控制台输出的ConstraintViolationException是**持久化阶段（调用templateRepository.save(template)时）**由Hibernate抛出的，而非Spring MVC在接收@RequestBody时的参数校验异常。Spring Boot默认异常处理器只会处理@Valid触发的MethodArgumentNotValidException，对于持久层抛出的ConstraintViolationException，直接返回500错误，不会解析并返回具体校验信息。

方案1：在DTO层添加校验注解，提前拦截错误 #

将@NotNull、@NotEmpty等校验注解移至TemplateDTO的对应字段，让Spring MVC在接收请求时通过@Valid触发校验，抛出MethodArgumentNotValidException，此时Spring Boot会自动返回包含具体错误信息的400响应。

修改后的TemplateDTO示例：

public class TemplateDTO {
    @NotNull
    @NotEmpty
    private String nome;
    // 其他字段及getter/setter方法
}

方案2：自定义全局异常处理器，处理ConstraintViolationException #

若需要保留实体类的兜底校验（防止非法数据入库），可以添加全局异常处理器，捕获ConstraintViolationException并返回结构化的错误响应：

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<Map<String, Object>> handleConstraintViolationException(ConstraintViolationException ex) {
        List<String> errors = ex.getConstraintViolations()
                .stream()
                .map(violation -> violation.getPropertyPath() + ": " + violation.getMessage())
                .collect(Collectors.toList());
        
        Map<String, Object> response = new HashMap<>();
        response.put("timestamp", LocalDateTime.now());
        response.put("status", HttpStatus.BAD_REQUEST.value());
        response.put("errors", errors);
        
        return new ResponseEntity<>(response, HttpStatus.BAD_REQUEST);
    }
}

补充说明 #

• 优先推荐方案1：在DTO层做参数校验，提前拦截非法请求，避免无效数据库操作，符合MVC分层设计思想。
• 实体类校验可作为兜底手段，配合方案2的全局异常处理器，确保任何场景下的校验错误都能返回清晰的提示信息。

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