Hibernate Validator正则表达式验证失效问题排查

核心原因：Java正则字符串转义错误 #

你在regex101中测试的是原生正则表达式，但直接复制到Java代码时，没有处理Java字符串的转义规则，导致Hibernate Validator解析的正则和测试版本不一致。

Java字符串里，反斜杠\必须用双重反斜杠\\表示；同时正则[]括号内的]、非首尾位置的-等字符也需要转义，否则会被解析为正则语法的一部分，而非普通匹配字符。

其他可能原因 #

• 密码带前后空格：实际接口接收的密码可能带有前端传入的前后空格，而你的正则用^和$限定了字符串首尾，导致匹配失败。可以在接口中打印传入的password值确认。
• @Pattern的flags参数干扰：如果给@Pattern设置了Pattern.Flag.MULTILINE等标志，会改变^和$的匹配行为（匹配行首/行尾而非字符串首尾），导致验证不通过。

解决步骤 #

1. 修正正则的Java字符串转义
   把你在regex101中验证通过的正则，转换成符合Java字符串规则的格式。例如原正则：

   ^(?=.*\d)(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%^&*()_+\-=[]{};':"\\|,.<>/?]).{8,20}$
   

   转换为Java字符串后应为：

   private static final String PASSWORD_REGEX = "^(?=.*\\d)(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%^&*()_+\\-=\\[\\]{};':\"\\\\|,.<>/?]).{8,20}$";
   

2. 修正实体类的@Pattern注解
   将转义后的正则应用到User实体的password字段：

   import jakarta.validation.constraints.Pattern;
   
   public class User {
       private static final String PASSWORD_REGEX = "^(?=.*\\d)(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%^&*()_+\\-=\\[\\]{};':\"\\\\|,.<>/?]).{8,20}$";
   
       @Pattern(regexp = PASSWORD_REGEX, message = "密码必须包含至少一位数字、小写字母、大写字母、指定特殊字符，长度在8-20位之间")
       private String password;
   
       // getter、setter方法
   }
   

3. 验证传入密码的实际值
   在接口方法中打印传入的password参数，确认没有前后空格或其他意外字符：

   @POST
   @Path("/users")
   public Response createUser(@Valid User user) {
       System.out.println("Received password: '" + user.getPassword() + "'");
       // 业务逻辑
       return Response.ok().build();
   }
   

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