Spring MVC校验异常：自定义提示未生效，BindingResult未触发求助

嘿，我一眼就揪出问题根源啦！你遇到的核心问题是**BindingResult参数的位置不符合Spring MVC的规则**，导致校验失败时Spring直接抛出异常跳过了你的方法逻辑，所以代码里的if(bindingResult.hasErrors())自然永远不会执行。

为什么判断逻辑从未触发？ #

Spring MVC有个严格的要求：BindingResult必须紧跟在被@Valid标记的参数后面，中间绝对不能插入其他参数（比如你代码里的Locale locale）。如果顺序不对，Spring在发现校验失败时会直接抛出MethodArgumentNotValidException，根本不会进入你的方法体，那这段判断代码当然没机会运行啦！

修复步骤 #

1. 调整参数顺序，让BindingResult紧跟被校验参数

把Locale locale移到BindingResult后面，修改后的方法签名和逻辑如下：

public @ResponseBody ResponseEntity<BaseModel> newTicket(
    @Valid @RequestBody Ticket ticket, 
    BindingResult bindingResult, 
    Locale locale
) {
    // 现在这段判断就能正常触发了
    if(bindingResult.hasErrors()) {
        logger.info("校验出错");
        // 提取自定义校验提示信息
        StringBuilder errorMsg = new StringBuilder();
        for(ObjectError error : bindingResult.getAllErrors()) {
            // 如果配置了国际化消息，结合Locale可以获取对应语言的提示
            String msg = messageSource.getMessage(error, locale);
            errorMsg.append(msg).append("; ");
        }
        // 返回带自定义提示的Bad Request响应
        return ResponseEntity.badRequest().body(new BaseModel(errorMsg.toString()));
        // 如果你仍想抛自定义异常，记得后续要全局捕获该异常并返回响应
        // throw new BadRequestException(errorMsg.toString());
    }
    // 正常业务逻辑处理
    return ResponseEntity.ok(new BaseModel("工单创建成功"));
}

2. 可选：全局异常处理（更优雅的方案）

如果不想在每个接口里重复写BindingResult的处理逻辑，可以用@ControllerAdvice全局捕获MethodArgumentNotValidException，统一返回自定义提示：

@ControllerAdvice
public class GlobalExceptionHandler {

    @Autowired
    private MessageSource messageSource;

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<BaseModel> handleValidationException(
        MethodArgumentNotValidException ex, 
        Locale locale
    ) {
        BindingResult bindingResult = ex.getBindingResult();
        StringBuilder errorMsg = new StringBuilder();
        for(ObjectError error : bindingResult.getAllErrors()) {
            String msg = messageSource.getMessage(error, locale);
            errorMsg.append(msg).append("; ");
        }
        return ResponseEntity.badRequest().body(new BaseModel(errorMsg.toString()));
    }
}

用这种方式的话，你甚至可以去掉方法里的BindingResult参数，Spring校验失败时会自动触发这个全局处理器，直接返回你配置的自定义提示信息。

额外提醒 #

确保你的Ticket实体类上的校验注解已经正确配置了message属性，比如：

public class Ticket {
    @NotNull(message = "工单ID不能为空")
    private String ticketId;

    @Size(min = 2, max = 20, message = "工单名称长度必须在2-20之间")
    private String ticketName;
    // getter、setter方法
}

这样不管是方法内处理还是全局处理，都能拿到你想要的自定义提示内容啦！

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