表单校验之@NotBlank,@NotNull,@NotEmpty之间的区别

最新推荐文章于 2025-06-06 10:28:56 发布
原创 最新推荐文章于 2025-06-06 10:28:56 发布 · 6.9k 阅读 · 13 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY 版权协议，转载请附上原文出处链接和本声明。

本文介绍了Java中三种常用的校验注解：@NotBlank用于确保String类型非空；@NotNull用于验证Integer类型非空；@NotEmpty则适用于检查List类型的非空状态。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

@NotBlank一般用来校验String类型不能为空

@NotNull一般用来校验Integer类型不能为空

@NotEmpty一般用来校验List类型不能为空

@NotNull与@NotBlank：非空校验你用对了吗？
**My Coding Family**
05-26 1039
🏆本文收录于《滚雪球学Spring Boot》，专门攻坚指数提升，2025 年国内最系统+最强（更新中）。    本专栏致力打造最硬核 Spring Boot 从零基础到进阶系列学习内容，🚀均为全网独家首发，打造精品专栏，专栏持续更新中…欢迎大家订阅持续学习。 如果想快速定位学习，可以看这篇【SpringBoot教程导航帖】,你想学习的都被收集在内，快速投入学习！！两不误。
SpringBoot开发——@NotEmpty和 @NotBlank的区别
bjzhang75的博客
12-20 1683
SpringBoot开发——@NotEmpty和 @NotBlank的区别
notBlank 和 notEmpty
qq_40813329的博客
07-01 2604
commons-lang 官方文档 isEmpty isNotEmpty（） StringUtils.isAnyEmpty（） isNoneEmpty（） isBank系列 isBlank（） 是否为真空值(空格或者空值) isNotBlank（） isAnyBlank（） isNoneBlank（） 其他方法
常用的校验注解之 @NotNull、@NotBlank、@NotEmpty 的区别
热门推荐
低调，谦虚，自律，反思，成长！
11-18 4万+
实体字段校验 @NotNull、@NotEmpty、@NotBlank 1.@NotNull 不能为 null，但可以为 empty，一般用在 Integer 类型的基本数据类型的非空校验上，而且被其标注的字段可以使用 @size、@Max、@Min 对字段数值进行大小的控制 2.@NotEmpty 不能为 null，且长度必须大于 0，一般用在集合类上 3.@NotBlank 只能作用在接收的 String 类型上，注意是只能，不能为 null，而且调用 trim() 后，长度...
注解 @NotEmpty 和 @NotNull区别
还在活水泥的未来包工头
06-06 1031
是 Java 中用于数据校验的注解，它们都来自 Jakarta Bean Validation 框架（之前称为 Hibernate Validator），但适用场景和约束强度有所不同。若需进一步校验列表元素（如字符串不为空），可结合。字段，应优先使用 @NotEmpty。
NotNull,NotEmpty,NotBlank三种空校验器的区别
weixin_44214857的博客
12-28 510
NotNull,NotEmpty,NotBlank三种空校验器的区别
@NotEmpty、@NotBlank、@NotNull
Java烂笔头
06-06 531
   验证框中@NotEmpty、@NotBlank、@NotNull乍一看还是容易弄混的。主要使用情况记录一下： @NotEmpty 用在集合类上面 @NotBlank 用在String上面 @NotNull    用在基本类型上
表单校验之@NotBlank,@NotNull,@NotEmpty之间的区别（重要！！我居然都没注意过！）
HD243608836的博客
04-28 426
@NotBlank一般用来校验String类型不能为空 @NotNull一般用来校验Integer类型不能为空 @NotEmpty一般用来校验List类型不能为空
@NotNull、@NotBlank 和 @NotEmpty 注解的区别
千层冷面的博客
01-16 736
NotNull: 确保对象不是null，但不检查空字符串或集合的空性。@NotBlank: 确保字符串不是null，并且去除前后的空白字符后至少包含一个字符。@NotEmpty: 确保集合不是null，并且至少包含一个元素。
@NotEmpty、@NotBlank等注解的正确使用 @Validated和@Valid的区别 解决@NotBlank等注解不生效的问题 使用BindingResult进行接口请求参数的统一校验
念兮为美
08-11 7753
本文带你了解如何正确地使用@NotEmpty、@NotBlank等注解、@Validated和@Valid的区别、解决@NotBlank等注解不生效的问题、使用BindingResult进行(controller)接口请求参数的统一校验。 为什么使用注解呢？因为服务端通常将`controller层`作为调用的第一层，因而参数校验常常在这里完成。假如在controller层的某个方法中，有很多个需要校验的请求参数，这样写无疑会有多条if判断语句，因而，我们需要使用优雅的方式处理接口请求参数。......
@NotBlank @NotNull @NotBlank校验非空注解怎么获得自定义message
qq_40600507的博客
04-09 1万+
由于我们提交的表单中字段通常都比较多，如果一个一个的去判断是否为空太麻烦，所以我们通常会使用@NotBlank @NotNull @NotBlank注解校验参数，但字段为空时会抛出MethodArgumentNotValidException异常，包含的信息太多，我们仅需要获取到自定的message返回给前端即可 org.springframework.web.bind.MethodArgume...
注解的其他补充 --- NotNull、NotEmpty、NotBlank的区别
qq_40493736的博客
01-01 701
在使用Validation验证框架时,要在控制器类的参数列表中对应DTO类的前面添加注解,否则会不起作用 最常用的校验注解:
NotNull、NotBlank、NotEmpty的使用
qq_35981356的博客
08-19 1219
NotNull：校验对象不为null NotBlank：校验字符串是否为null、或者空字符串，去除空格 NotEmpty：校验集合是否为null、或者长度是否为0
springboot List对象中的属性使用@NotBlank
LCRxxoo的博客
06-04 702
注解通常用于验证字符串是否为空或仅包含空格。如果你想针对列表中的对象特定属性进行判断，可以使用。在Spring Boot中，
@NotBlank、@NotNull 、@NotEmpty 区别和使用
weixin_47316183的博客
06-08 1595
介绍了@NotNull与@NotBlank的区别和使用
javax.validation.constraints.Notnull@NotNull@NotBlank注解在Integer属性上失效，报错相关问题
Utaha_的博客
06-15 1472
NotNull@NotBlank注解都加到一个Integer属性上，会校验报错。弄明白用法后，报错如何解决就显而易见了。通过查看相关资料，三个注解的区别如下。
参数校验的@NotNull和@NotBlank的区别
smileLs的博客
10-09 1594
@NotNull和@NotBlank的区别 @NotBlank只能注释在字符串字段(String)上；不能注释在Integer；注释Integer的类型要用@NotNull 否则会报"HV000030: No validator could be found for type: java.lang.Integer ...
@NotBlank注解、@NotEmpty注解、@NotNull注解的正确使用
林立鹏的博客
09-15 1225
@NotBlank注解、@NotEmpty注解、@NotNull注解的正确使用
@NotEmpty和@NotBlank的区别是什么
最新发布
08-15
<think>我们正在讨论Java Bean Validation中的两个注解：@NotEmpty和@NotBlank。根据引用[1]和引用[2]的内容，我们可以总结如下： 1. **@NotEmpty**: - 适用类型：字符串、集合（如List, Set, Map等） - 验证条件：被注解的元素不能为null，并且字符串长度必须大于0（即不能是空字符串""），集合大小必须大于0（即不能是空集合）。 - 示例无效值：对于字符串：null, ""；对于集合：null, []（空集合）。 2. **@NotBlank**: - 适用类型：仅字符串（注意：不能用于集合） - 验证条件：被注解的字符串不能为null，并且必须至少包含一个非空白字符（即不能是空字符串""，也不能是纯空格字符串）。 - 示例无效值：null, "", " "（空格字符串）。 ### 核心区别总结： - **@NotEmpty** 用于确保字符串或集合非空（有内容），但字符串内容可以是空格（如" "）？注意：实际上@NotEmpty对字符串的要求只是长度大于0，所以" "（空格字符串）是合法的，因为它长度大于0。 - **@NotBlank** 专门针对字符串，要求字符串必须有至少一个非空白字符（即trim()后的长度大于0）。所以，对于字符串" "（空格字符串），@NotBlank会校验失败，而@NotEmpty会通过。 ### 示例代码说明： ```java public class Example { @NotEmpty private String str1; // 有效值: "a", " ", " "（空格字符串有效，因为长度>0）; 无效值: null, "" @NotBlank private String str2; // 有效值: "a", " a "（有非空格字符）; 无效值: null, "", " "（纯空格） } ``` ### 组合使用建议（引用[1]）： 在复杂场景中，可以组合使用注解。例如： ```java public class Product { @NotNull // 确保对象不为null @NotEmpty // 确保名称非空（且长度>0） private String name; } ``` 但注意，对于字符串，如果你希望它非空且不能是纯空格，那么应该使用`@NotBlank`，而不需要同时使用`@NotNull`和`@NotEmpty`，因为`@NotBlank`已经隐含了非null且至少有一个非空白字符（即长度至少为1，且不是全空格）。 ### 错误处理： 当验证失败时，会抛出`ConstraintViolationException`（在方法参数验证中可能是`MethodArgumentNotValidException`），可以通过全局异常处理器捕获并返回友好错误消息。 ### 性能考虑： 这些注解在运行时通过反射验证，性能开销小，适合高频API调用。 ### 相关问题： 1. 在Spring Boot中如何自定义验证错误消息？ 2. 如何为集合类型（如List）使用@NotEmpty注解？ 3. 除了@NotEmpty和@NotBlank，还有哪些常用的Bean Validation注解？</think>### Java Bean Validation 中 `@NotEmpty` 与 `@NotBlank` 的区别详解 #### 1. **核心差异对比** | 特性 | `@NotEmpty` | `@NotBlank` | |------------------|--------------------------------------|--------------------------------------| | **适用类型** | 字符串、集合（List/Set/Map） | **仅字符串** | | **验证条件** | 非 null + 非空（长度 > 0 或大小 > 0）| 非 null + 至少一个非空白字符 | | **无效值示例** | `null`, `""`, `[]` | `null`, `""`, `" "`（纯空格） | | **空格处理** | 允许纯空格字符串（如 `" "`） | **禁止纯空格** | | **严格等级** | ★★☆☆☆ | ★★★★★ | > **关键区别**：`@NotBlank` 是 `@NotEmpty` 的严格升级版，专为字符串设计，额外要求**内容不能是纯空白字符**[^1]。 --- #### 2. **代码行为演示 ```java public class User { // 允许："a", " "（纯空格） | 拒绝：null, "" @NotEmpty(message = "姓名不能为空") private String name1; // 允许："a", " a " | 拒绝：null, "", " "（纯空格） @NotBlank(message = "姓名需包含有效字符") private String name2; } ``` - **`@NotEmpty` 通过但 `@NotBlank` 失败的情况**： ```java user.setName1(" "); // 通过（纯空格） user.setName2(" "); // 失败！触发message ``` --- #### 3. **实际应用场景建议** 1. **表单输入校验**： - 用 `@NotBlank` 验证用户名/地址（避免用户输入空格糊弄系统） - 用 `@NotEmpty` 验证下拉菜单选项（只需确保有选择） 2. **组合使用增强校验**： ```java public class Product { @NotNull @NotBlank // 双重保障：非null + 非空白 private String skuCode; } ``` 3. **集合类专用**： ```java public class Order { @NotEmpty // 仅用于集合：确保items非空 private List<Item> items; } ``` --- #### 4. **错误处理机制 当校验失败时： ```java // Spring 中自动捕获异常 @ExceptionHandler(MethodArgumentNotValidException.class) public ResponseEntity<Error> handleValidationException( MethodArgumentNotValidException ex) { // 提取错误信息: ex.getBindingResult().getAllErrors() } ``` - 返回示例：`{"field": "name2", "message": "姓名需包含有效字符"}`[^2] --- ### 总结选择策略 | 场景 | 推荐注解 | |-------------------------------|---------------| | 需严格拒绝纯空格的文本字段 | `@NotBlank` | | 允许空格但禁止空值的文本字段 | `@NotEmpty` | | 集合/数组的非空校验 | `@NotEmpty` | | 基础非null校验（非字符串） | `@NotNull` | > **性能提示**：这些注解通过编译时字节码增强实现，运行时开销极小（纳秒级）[^1]。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值