喜提一个bug，聊聊@NotEmpty和@NotBlank

野生技术架构师2026-01-06 8:44

前言

上个版本，测试给我提了一个bug，说一个来源字段，传个空白字符串，也能更新成功，建议做一下校验。

我想了一下，我的属性确实有校验呀：

复制代码

@NotEmpty(message = "source must not be empty")
private String source;

@NotEmpty 跟 StringUtils.isEmpty 校验效果是一样的，点进去源码一看，发现确实用得不太对：

复制代码

public static boolean isEmpty(CharSequence cs) {
   return cs == null || cs.length() == 0;
}

如果传空白字符串的话，长度大于0的话，@NotEmpty并不能校验出来。

1. 复现demo

复制代码

String source ="  ";
System.out.println(StringUtils.isEmpty(source));
//输出长度
System.out.println(source.length());

运行结果：

复制代码

false
2

传一个空白字符串，运行的结果是false。

因为isEmpty 校验的是，不能为null，而且长度必须大于0，而空的字符串，长度是大于0的，所以返回false。

2. 正确的使用方式

我们在校验空白字符串的时候，要用StringUtils.isBlank。它用于检查字符串是否为空白 （null、长度为 0 或仅包含空白字符）

复制代码

String source ="  ";
System.out.println(StringUtils.isBlank(source));

运行结果：

复制代码

true

大家可以看下它的源码：

复制代码

public static boolean isBlank(CharSequence cs) {
       int strLen = length(cs);
       if (strLen == 0) {
           returntrue;
       } else {
           for(int i = 0; i < strLen; ++i) {
               if (!Character.isWhitespace(cs.charAt(i))) {
                   returnfalse;
               }
           }

           returntrue;
       }
   }

有这个Character.isWhitespace，嘻嘻，真相。因此，大家在日常开发中，做校验的时候，要注意这个哈。

3. @NotNull和@NotEmpty和@NotBlank区别

常用的注解还有@NotNull，我说说它们三的区别吧：

@NotNull: 不能为null，但可以为空（如空字符串或空集合）
@NotEmpty: 不能为null,可以为空的字符串 ，但长度必须大于0
@NotBlank：不能为 null，不能为空字符串