默认返回全部错误，因spring boot的@valid自动收集所有字段错误；可按需截取首个错误以适配简单表单，或通过注解、请求头灵活切换模式，并建议用错误码映射替代默认提示以提升可控性。
校验失败时返回“首个错误”还是“全部错误”，不是技术限制问题，而是设计取舍——关键看前端交互需求和调试成本。默认 Spring Boot 的 @Valid 会收集所有字段错误，但你可以按需控制输出粒度。
一、默认行为：校验失败自动返回全部错误字段
只要引入 spring-boot-starter-validation 并在 DTO 上加注解（如 @NotBlank, @Min(1)），Spring 就会在绑定参数时触发校验。若失败，抛出 MethodArgumentNotValidException，它内部的 BindingResult 已包含全部错误项。
你只需在全局异常处理器中提取并决定怎么返回：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 调用
bindingResult.getAllErrors()→ 获取全部ObjectError或FieldError - 遍历每个
FieldError，用getField()+getDefaultMessage()拼装提示 - 常见做法是组装成 Map
或自定义错误列表（如 [{"field":"email","msg":"邮箱格式不正确"}]）
二、只返回首个错误：适合简单表单或强引导场景
当用户提交一个登录表单，你只想提示“用户名不能为空”，而不是同时列出“密码太短”“验证码错误”——这时主动截断即可：
- 在
@ExceptionHandler(MethodArgumentNotValidException.class)方法里，只取bindingResult.getFieldError()（注意无 s），它返回第一个字段错误 - 或用
bindingResult.getAllErrors().get(0)，再判断是否为FieldError类型以提取字段名 - 响应体可简化为：
{"code":400,"message":"用户名不能为空","field":"username"}
三、按环境/接口灵活切换：用注解或参数控制
硬编码“只取第一个”不够灵活。更实用的方式是分层支持：
- 定义一个轻量注解，比如
@FirstErrorOnly，加在 Controller 方法上，再通过HandlerMethod在异常处理器中识别 - 或约定请求头（如
X-Validation-Mode: first），在异常处理逻辑中读取并分支处理 - 对管理后台类接口，默认返回全部错误；对 H5 轻量页，默认只返回首个，降低前端解析负担
四、进阶：自定义校验器 + 错误码映射，替代默认提示
直接返回 getDefaultMessage() 容易暴露实现细节（如 “must be greater than or equal to 1”）。建议统一转为业务错误码：
- 为每个校验注解定义对应枚举，例如
UserErrorCode.USER_AGE_TOO_LOW(2101, "年龄不能小于18") - 在校验失败时，不依赖默认提示，而是根据
FieldError.getCode()（如Min）查表匹配错误码 - 这样无论返回一个还是多个错误，内容都可控、可翻译、可监控
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
