@NotNull注解与@Column的nullable属性差异及失效问题排查

嘿，这个问题我之前在项目里也踩过坑，咱们好好捋一捋：

为什么@NotNull注解没起作用？ #

@NotNull 是Bean Validation（也就是常说的JSR-380/Hibernate Validator）的注解，它的作用范围是Java对象层面，属于应用层的业务校验。它不会自动生效，得满足两个前提：

• 你的代码里必须触发Bean Validation的校验流程：比如在Spring MVC接口中给入参加上@Valid注解，或者在Service层手动调用Validator.validate()方法来校验实体。如果没做这一步，这个注解就跟没加一样，数据自然能顺利存入数据库。
• 部分JPA实现（比如Hibernate）默认不会在持久化操作（save/persist）时自动触发Bean Validation，除非你在配置里开启了相关校验器，或者手动触发校验逻辑。

你最开始的代码是这样的：

@NotNull @Column(name = "postal_code") private String postalCode;

因为没触发校验流程，所以@NotNull根本没发挥作用，null值就被存入数据库了。

@NotNull与@Column(nullable = false)的核心区别 #

这两个注解看起来功能类似，但其实作用在完全不同的层面：

• 作用范围不同
  • @NotNull：只在应用层生效，用来校验Java实体对象的属性是否为null，不会影响数据库表的结构（哪怕你加了这个注解，数据库里的postal_code列依然可能允许null）。
  • @Column(nullable = false)：是JPA的注解，作用于数据库表结构层面，在生成表时会把postal_code列设置为NOT NULL，属于数据库级别的约束。
• 触发逻辑不同
  • @NotNull必须由应用代码主动触发校验，比如接口入参用@Valid标记，或者手动调用校验器。如果没触发，就不会拦截null值。
  • @Column(nullable = false)的约束是数据库自带的，只要插入/更新时该字段为null，数据库会直接抛出异常拒绝操作，不管应用层有没有做校验。
• 错误类型不同
  • @NotNull校验失败会抛出Bean Validation相关的异常（比如ConstraintViolationException），这是应用层的异常，可以轻松捕获并返回友好的业务提示。
  • @Column(nullable = false)违反约束时，会抛出数据库层面的异常（比如SQLIntegrityConstraintViolationException），属于数据库返回的错误，需要专门处理这类异常。

小建议 #

实际项目里通常推荐两者结合使用：用@NotNull在应用层提前拦截错误，提升用户体验；用@Column(nullable = false)作为最后一道防线，防止因为应用层校验遗漏导致脏数据进入数据库。

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