Spring Boot参数校验自定义分三步：一是用注解message属性写静态提示；二是通过messages.properties国际化+占位符实现多语言；三是用全局异常处理器统一返回聚合错误信息，并可进阶自定义注解动态注入字段名。
Spring Boot 中参数校验错误信息的自定义，核心在于两步：一是用标准注解（如 @NotBlank、@Min）声明规则并指定 message 属性；二是通过全局异常处理器捕获校验失败抛出的异常，统一格式化返回给前端。
直接在注解里写提示语
这是最简单的方式，适合中英文固定、无需动态变化的场景。每个校验注解都支持 message 属性：
@NotBlank(message = "用户名不能为空") private String username;@Email(message = "邮箱格式不合法，请检查后重试") private String email;@Size(min = 6, max = 20, message = "密码长度必须在6到20位之间") private String password;
注意：这种方式的提示是静态字符串，字段名、数值等不会自动替换，也不支持多语言切换。
用国际化消息文件统一管理
把所有提示语抽离到 messages.properties（或 messages_zh_CN.properties、messages_en_US.properties），再通过占位符动态注入字段名和参数值：
- 在
messages.properties中写：notblank.constraint=字段 {0} 不能为空size.constraint=字段 {0} 长度必须在 {1} 到 {2} 之间 - 实体类中引用：
@NotBlank(message = "{notblank.constraint}") private String username;@Size(min = 6, max = 20, message = "{size.constraint}") private String password;
这样就能复用同一套模板，配合 Spring 的 MessageSource 实现语言自动切换。但要注意：标准注解的 message 不会自动填充 {0} 字段名——需要搭配自定义约束注解 + 自定义 ConstraintValidator 才能真正实现运行时字段名注入。
全局异常处理器统一返回结构
校验失败默认抛出 MethodArgumentNotValidException（JSON 请求体）或 BindException（表单/查询参数），它们携带了完整的错误详情。你需要在 @RestControllerAdvice 类中拦截并组装友好响应：
- 提取所有字段错误：
Listerrors = ex.getBindingResult().getFieldErrors(); - 拼接成易读格式，比如：
username: 用户名不能为空; password: 密码长度必须在6到20位之间 - 返回统一 JSON 结构，例如：
{"code": 4000, "message": "username: 用户名不能为空; password: 密码长度必须在6到20位之间", "data": null}
关键点：不要只返回第一个错误，要聚合全部；状态码建议用 200（业务成功但参数有误），而非 400，避免前端误判为网络异常。
进阶：自定义注解支持动态字段名
如果想让提示语里自动显示真实字段名（如 “邮箱” 而不是 “email”），或带具体数值（如 “最小长度为8”），就得自己写注解：
- 定义新注解，如
@ValidEmail，不写message属性 - 实现
ConstraintValidator，在isValid方法中调用messageSource.getMessage("email.format", new Object[]{fieldName, "xxx@xx.com"}, locale) - 配合 Spring 的
ConfigurableListableBeanFactory注入字段名，实现类似email.format=字段 {0} 的值 {1} 不符合邮箱格式的效果
这种方式灵活性最高，适合中大型项目对提示语体验要求严格的场景。
