使用Hibernate Validator时如何强制所有校验注解填写message属性

方案1：静态代码检查拦截（推荐首选） #

• 基于Checkstyle/SpotBugs/Alibaba Java Coding Guidelines等代码检查工具编写自定义规则：
  • 规则逻辑：扫描所有类的字段/方法上的校验注解（包括原生Jakarta/Java Validation注解、自定义校验注解），检查是否显式给message属性赋值，未赋值则直接抛出编译错误/CI门禁拦截。
  • IDE层面也可以同步配置自定义Inspection规则，开发写代码时就能实时提示漏填问题。
• 特点：问题发现时机最早，在编码/提交代码阶段就拦截，对业务代码无侵入。

方案2：封装自定义派生校验注解 #

• 对所有原生校验注解做一层二次封装，派生的自定义注解不设置message的默认值，强制开发填写：
  示例代码如下：

  import jakarta.validation.*;
  import jakarta.validation.constraints.NotNull;
  import java.lang.annotation.*;
  
  @Target({ElementType.FIELD, ElementType.PARAMETER})
  @Retention(RetentionPolicy.RUNTIME)
  @Constraint(validatedBy = {})
  @NotNull // 挂载原生注解能力
  public @interface RequireNotNull {
      // 不设置default值，使用时必须显式赋值
      String message();
      Class<?>[] groups() default {};
      Class<? extends Payload>[] payload() default {};
  }
  

• 同步在代码规范中禁止直接使用原生校验注解，只能使用团队统一封装的派生注解。
• 特点：强制约束最彻底，不会出现漏网之鱼，缺点是需要提前封装所有用到的原生校验注解，对开发使用习惯有少量调整成本。

方案3：运行期兜底校验 #

• 项目启动时增加初始化逻辑，扫描所有业务POJO类，反射读取所有字段上的校验注解：
  • 判断注解的message值是否为原生默认值（比如原生@NotNull的默认值为"{jakarta.validation.constraints.NotNull.message}"），如果是默认值则直接抛出异常终止项目启动。
• 特点：作为前两个方案的兜底防线，防止静态检查漏判的情况流入发布环节。

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