本文详解如何在 hibernate tools（hbm2java）反向工程数据库后，为带 `default` 约束的字段（如 `current_timestamp` 或复杂表达式）正确配置 jpa 注解，避免 `dataintegrityviolationexception`。
当使用 Hibernate Tools 的 hbm2java 工具从数据库反向生成 JPA 实体类时，一个常见且易被忽视的问题是：数据库列定义中的 DEFAULT 约束（例如 DEFAULT CURRENT_TIMESTAMP 或 DEFAULT 'User' + CAST(NEXT VALUE FOR Seq... AS VARCHAR)）不会自动映射到生成的 Java 字段上。这导致实体字段在插入时为 null，而数据库又要求非空（NOT NULL），最终触发 DataIntegrityViolationException。
根本原因在于：hbm2java 仅基于表结构元数据（如列名、类型、是否为空）生成代码，不解析或读取数据库的 DEFAULT 表达式——无论该表达式是标准 SQL（CURRENT_TIMESTAMP）、数据库特有函数（如 SQL Server 的 GETDATE()），还是序列拼接逻辑（如 'User' + NEXT VALUE FOR SeqUserAccountUsername）。因此，生成的字段既无初始值，也无语义提示告知 Hibernate “该值应由数据库生成”。
✅ 正确解决方案：组合使用 @Generated 与 @ColumnDefault
Hibernate 提供了两个关键注解协同解决此问题：
- @Generated(INSERT)：明确告诉 Hibernate，该字段的值由数据库在 INSERT 时生成，Hibernate 在 INSERT 语句中将完全忽略该字段（不包含在 INSERT INTO ... VALUES(...) 中），并期望数据库返回其生成值（需配合 @Column(insertable = false) 或数据库支持的 RETURNING/OUTPUT 子句）；
- @ColumnDefault("...")：非 JPA 标准注解，而是 Hibernate 特有扩展（位于 org.hibernate.annotations.ColumnDefault），用于在 DDL 生成时声明默认值（如建表），更重要的是：它会参与 hbm2ddl 的 schema 验证，并在某些场景下影响 INSERT 行为逻辑（尤其与 @Generated 配合时）。
对于你的 Created 字段，推荐写法如下：
import javax.persistence.*;
import org.hibernate.annotations.ColumnDefault;
import org.hibernate.annotations.Generated;
import org.hibernate.annotations.GenerationTime;
@Temporal(TemporalType.TIMESTAMP)
@Column(name = "CREATED", nullable = false)
@ColumnDefault("CURRENT_TIMESTAMP")
@Generated(GenerationTime.INSERT)
public Timestamp getCreated() {
return this.created;
}
public void setCreated(Timestamp created) {
this.created = created;
}⚠️ 注意事项：@Generated(INSERT) 是核心——它确保 Hibernate 不尝试插入 null，而是让数据库接管；@ColumnDefault("CURRENT_TIMESTAMP") 增强语义，并兼容不同方言（如 PostgreSQL 用 NOW()，MySQL 用 CURRENT_TIMESTAMP）；若你使用 spring.jpa.hibernate.ddl-auto=validate 或 update，该注解还能帮助 Hibernate 检测 schema 是否匹配；不要在字段上添加 @Column(insertable = false) —— 因为 @Generated 已隐含此行为；若手动设为 false，可能导致无法获取数据库返回的生成值（除非同时配置 @Column(updatable = false) 并启用 select-before-update）。
? 复杂默认值（如 'User' + NEXT VALUE FOR Seq...）如何处理？
对于类似 SQL Server 的序列拼接表达式：
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
DEFAULT 'User' + CAST(NEXT VALUE FOR SeqUserAccountUsername AS VARCHAR(19))
@ColumnDefault 仍可直接使用字符串形式（注意转义和方言兼容性）：
@ColumnDefault("'User' + CAST(NEXT VALUE FOR SeqUserAccountUsername AS VARCHAR(19))")
@Generated(GenerationTime.INSERT)
@Column(name = "USERNAME", nullable = false, length = 50)
public String getUsername() {
return this.username;
}✅ 优势：
- 完全交由数据库计算，保证原子性与一致性；
- 无需在 Java 层维护序列逻辑或并发安全计数器；
- hbm2java 生成后只需手动补加这两行注解，即可开箱即用。
❌ 不推荐方案：
- 在 @PrePersist 中手动设置 new Timestamp(System.currentTimeMillis())：绕过数据库默认值，丧失事务一致性，且无法处理 'User13' 类型的业务逻辑；
- 使用 @DefaultValue（已废弃）或 @Column(columnDefinition = "...")：后者仅影响 DDL，不改变 INSERT 行为，仍会传 null 导致失败。
✅ 最佳实践总结
| 场景 | 推荐方式 | 关键注解 |
|---|---|---|
| TIMESTAMP DEFAULT CURRENT_TIMESTAMP | @Generated(INSERT) + @ColumnDefault("CURRENT_TIMESTAMP") | @Generated, @ColumnDefault |
| 序列拼接（SQL Server/Oracle） | 同上，@ColumnDefault 写原生 DB 表达式 | @ColumnDefault, @Generated |
| 希望 Hibernate 自动回填生成值（如主键） | @GeneratedValue + @GenericGenerator（仅适用于主键） | 不适用本例（非主键） |
| 所有默认值统一管理 | 不依赖 hbm2java 自动生成：先手写实体，再用 hibernate-tools 生成 mapping 文件（.hbm.xml），或改用 jOOQ / MyBatis Generator 等支持默认值提取的工具 | — |
最后提醒：完成注解添加后，务必清理并重新生成源码（./mvnw clean generate-sources），并验证 INSERT 操作是否成功且数据库返回了预期值。你无需修改任何业务逻辑——Hibernate 会在执行 SQL 后自动将数据库生成的 CREATED 和 USERNAME 值同步回实体对象。
