Java正则校验字符串仅含字母数字及.-时匹配失效问题

需求说明 #

需要实现的字符串校验规则：

• 禁止包含@、$等非法特殊字符
• 仅允许出现大小写字母、数字、-（中划线）、.（点号）四类字符
  校验逻辑使用Java原生String.matches()方法实现，此前尝试的4种正则写法均失效，甚至输入仅含字母、数字、点号的纯合法字符串也会返回false。

此前错误写法汇总 #

• 写法1：String regex = "^[a-zA-Z0-9_-.]*$";
• 写法2：String regex = "+/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/i";
• 写法3：String regex = "^([-.A-Za-z0-9]){1,20}$";
• 写法4：String regex = "^[a-zA-Z0-9_-.]*";

错误原因 #

1. 字符组内-位置错误：正则字符组中-是特殊元字符，代表ASCII范围匹配，若不放在字符组的最开头/最末尾、也不做转义，会被解析为范围运算符。比如写法1里的_-.会被识别为匹配ASCII码从_（95）到.（46）的倒序区间，直接导致字符组匹配逻辑完全错乱，这是多数写法失效的核心原因。
2. 混入其他语言正则语法：写法2带了JavaScript正则的字面量分隔符/、忽略大小写修饰符i、开头多余的+符号，Java的matches()方法仅接收纯正则字符串，不需要这类字面量标记。
3. 缺少结尾锚定：写法4没有加全串匹配的结尾锚点$，会导致只要字符串开头是合法字符，尾部带非法字符也能匹配通过，不符合全串校验要求。

正确正则写法 #

根据业务的长度要求选择对应写法即可，原有matches()判断逻辑不需要修改：

1. 允许空串场景：

String regex = "^[a-zA-Z0-9.-]*$";

2. 要求至少1位合法字符场景：

String regex = "^[a-zA-Z0-9.-]+$";

3. 限制长度1-20位场景：

String regex = "^[a-zA-Z0-9.-]{1,20}$";

注意：上述正则中-放在字符组的最末尾，不会被识别为范围运算符，无需额外转义；如果习惯把-放字符组最开头，写成^[-a-zA-Z0-9.]+$效果完全一致。

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