【notnull注解怎么用】在 Java 开发中，尤其是在使用一些框架如 Hibernate、Spring 或者进行数据校验时，`@NotNull` 注解是一个非常常见的工具。它主要用于对字段或方法参数进行非空校验，确保程序运行过程中不会出现 `NullPointerException` 的问题。
下面我们将从基本概念、使用方式、注意事项等方面进行总结，并通过表格形式直观展示其使用场景和效果。
一、什么是 @NotNull 注解？
`@NotNull` 是一个用于字段或方法参数的注解，表示该字段或参数不能为 `null`。它通常与 Bean Validation（如 JSR 303/380）一起使用，用于在对象赋值、方法调用等场景下进行参数校验。
常见于以下库中：
- Hibernate Validator
- Spring Framework（结合 @Valid 或 @Constraint）
- Jakarta Bean Validation
二、@NotNull 注解的使用方式
| 使用位置 | 示例代码 | 说明 |
| 字段上 | `@NotNull private String name;` | 表示该字段不能为 null |
| 方法参数上 | `public void setName(@NotNull String name)` | 表示传入的参数不能为 null |
| 方法返回值上 | `@NotNull public String getName()` | 表示返回值不能为 null |
> 注意：`@NotNull` 不会自动校验集合类（如 List、Map），如果需要校验集合中的元素是否为空，应使用 `@NotEmpty` 或自定义校验逻辑。
三、@NotNull 的作用场景
| 场景 | 是否适用 | 说明 |
| 数据库实体字段校验 | ✅ | 用于防止数据库插入 null 值 |
| API 接口参数校验 | ✅ | 防止非法请求传入 null 参数 |
| 业务逻辑参数检查 | ✅ | 提前发现错误输入，避免后续异常 |
| 集合类型校验 | ❌ | 需要配合其他注解使用，如 `@NotEmpty` |
| 自定义校验逻辑 | ⚠️ | 可以作为校验条件的一部分 |
四、使用注意事项
1. 依赖支持：`@NotNull` 属于 Bean Validation 规范的一部分，需要引入对应的依赖，例如：
- Spring Boot 中默认包含 `spring-boot-starter-validation`
- 手动添加 `hibernate-validator` 依赖
2. 校验触发时机：`@NotNull` 注解本身不会自动触发校验，需要配合 `Validator` 实例或者 Spring 的 `@Valid` 注解来触发。
3. 不同框架行为差异：在某些框架中（如 MyBatis），`@NotNull` 可能不被识别，需结合具体框架文档确认。
4. 与 @NotBlank 区别：`@NotNull` 检查的是对象是否为 null，而 `@NotBlank` 还会检查字符串是否为空白字符。
五、总结
| 内容 | 说明 |
| 用途 | 用于校验字段或参数是否为 null |
| 支持框架 | Hibernate Validator、Spring、Jakarta Bean Validation |
| 使用位置 | 字段、方法参数、方法返回值 |
| 不适用场景 | 集合类型、自定义对象嵌套校验 |
| 校验方式 | 需要配合 Validator 或 @Valid 触发 |
通过合理使用 `@NotNull` 注解，可以有效提升代码健壮性，减少因 null 值导致的运行时异常。在实际开发中，建议结合其他注解（如 `@NotBlank`、`@NotEmpty`）形成完整的校验体系，确保数据质量。
