Spring Boot中BindingResult单字段返回两条重复错误信息的问题解决

原因说明 #

出现两条相同的"must not be null"错误，核心原因是：

• 当提交空字符串""给Date类型字段时，Spring MVC的参数绑定阶段无法将空字符串转换为Date，会自动将该字段值设为null，此时会生成一条类型转换相关的非空错误；
• 同时，@NotNull注解的校验器检测到字段为null，又生成一条非空错误；
• 最终两条错误信息完全一致，导致响应中出现重复条目。

这不属于框架的异常问题，而是参数绑定与校验逻辑共同作用的结果。

修复方法 #

方法1：错误处理器中对重复错误去重 #

如果希望保留所有校验逻辑，只需要在错误处理器中对同一字段的相同错误信息去重：

@Override
protected ResponseEntity<Object> handleMethodArgumentNotValid(final MethodArgumentNotValidException ex, 
                                                              final HttpHeaders headers, 
                                                              final HttpStatus status, 
                                                              final WebRequest request) {
    logger.info(ex.getClass().getName());

    // 使用LinkedHashMap保证顺序，同时去重同一字段的相同错误
    final Map<String, String> errors = new LinkedHashMap<>();

    for (final FieldError error : ex.getBindingResult().getFieldErrors()) {
        String key = error.getField();
        String message = error.getDefaultMessage();
        // 仅当该字段没有相同错误时才存入
        if (!errors.containsKey(key) || !errors.get(key).endsWith(message)) {
            errors.put(key, String.format("%s %s", key, message));
        }
    }

    return new ResponseEntity<>(errors, HttpStatus.BAD_REQUEST);
}

方法2：提前拦截空字符串的类型转换问题 #

通过自定义类型转换器，将空字符串转换为null，在绑定阶段处理空字符串，避免生成重复错误：

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;

@Component
public class StringToDateConverter implements Converter<String, Date> {
    private final SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");

    @Override
    public Date convert(String source) {
        if (source == null || source.trim().isEmpty()) {
            return null;
        }
        try {
            return dateFormat.parse(source.trim());
        } catch (ParseException e) {
            throw new IllegalArgumentException("Invalid date format, please use yyyy-MM-dd");
        }
    }
}

这样空字符串会被转换为null，只会触发@NotNull的一次校验，避免重复错误。

额外建议 #

• 在实体类字段上添加@DateTimeFormat(pattern = "yyyy-MM-dd")注解，明确指定日期格式，减少转换异常；
• 确保请求体中的日期格式与后端预期一致，避免不必要的类型转换错误。

内容的提问来源于stack exchange，提问作者Ngọc Đức