[Spring MVC]BindingResult

一.什么是BindingResult

BindingResult 接口用于处理数据绑定的错误和验证错误。

当用户提交表单时，Spring 会将请求中的表单数据绑定到 @参数校验注解注解指定的对象上。

如果在绑定过程中发生错误（如数据格式不正确、必填字段为空等），这些错误会被记录在 BindingResult 对象中。

BindingResult 提供了多种方法来查看、处理和报告这些错误，最常见的方法是 hasErrors()、getFieldErrors()、getGlobalErrors() 等。

通过这些方法，开发者可以在视图层向用户展示相应的错误信息，提升用户体验。

二.核心方法

所有方法均围绕 **"判断是否有错误"+"获取错误信息"** 展开，适配你图中通过校验的核心判定需求，按使用优先级排序，简单易上手：

2.1. 核心判定方法：hasErrors()

• 作用 ：判断参数校验是否存在错误，是你图中通过校验的核心判定依据
• 返回值 ：boolean（false= 无错误，执行你图的通过校验；true= 有错误，拦截并处理）
• 使用场景 ：Controller 层参数校验的第一个判断步骤，必用！

java

运行

// 你图中Controller层的核心判定逻辑
if(bindingResult.hasErrors()){
    // 有错误：封装错误信息，直接返回前端，不进Model层
    return Result.fail(400, "参数校验失败");
}
// 无错误：执行你图的「通过校验」，传递DTO至Model层
userService.handle(dto);

2.2. 核心获取错误方法：getFieldErrors()

• 作用 ：获取所有字段的校验错误，返回封装好的错误列表，包含「错误字段名 + 自定义提示信息」
• 返回值 ：List<FieldError>（每个 FieldError 对应一个字段的错误）
• 使用场景 ：校验失败时，批量获取所有字段错误，拼接后返回前端，适配多字段校验的场景

java

运行

if(bindingResult.hasErrors()){
    // 拼接所有字段的错误信息：如「username:用户名不能为空；phone:手机号格式错误」
    String errorMsg = bindingResult.getFieldErrors().stream()
        .map(e -> e.getField() + ":" + e.getDefaultMessage())
        .collect(Collectors.joining("；"));
    return Result.fail(400, errorMsg);
}

2.3. 精准获取错误方法：getFieldError(String fieldName)

• 作用 ：根据指定字段名，精准获取单个字段的校验错误（适用于需要单独处理某个字段错误的场景）
• 参数 ：fieldName（DTO 中的字段名，如username/phone）
• 返回值 ：FieldError（单个字段的错误对象，无错误则返回null）
• 使用场景：对核心字段做单独错误提示，如登录场景单独提示 "密码错误"

java

运行

if(bindingResult.hasErrors()){
    // 仅获取password字段的错误
    FieldError pwdError = bindingResult.getFieldError("password");
    if(pwdError != null){
        return Result.fail(400, pwdError.getDefaultMessage());
    }
    return Result.fail(400, "参数错误");
}

2.4. 快速获取提示方法：getDefaultMessage()（FieldError 的配套方法）

• 作用 ：从FieldError对象中，获取注解中自定义的 message 提示（如 @NotBlank (message = "用户名不能为空") 的文字）
• 使用场景 ：配合getFieldErrors()/getFieldError()使用，是获取错误提示的最终方法

2.5. 全局错误方法：getGlobalErrors()

• 作用 ：获取非字段级的全局校验错误（极少用，一般不推荐）
• 适用场景：仅当使用全局校验注解（非字段注解）时才会用到，日常开发中几乎不用，了解即可。

code:

if (bindingResult.hasErrors()) {
    String errorMessage = bindingResult.getFieldErrors().stream()
            .map(fi -> fi.getField() + ":" + fi.getDefaultMessage())
            .collect(Collectors.joining(","));
    return Result.fail(errorMessage);
}