如何强制Hibernate 6返回java.util.Date而非java.sql.Timestamp？

问题背景 #

从Hibernate 5迁移至6.6版本后，仍在使用java.util.Date，但由于java.util.Date与java.sql.Timestamp的equals方法不兼容，且不需要纳秒精度，希望Hibernate始终返回java.util.Date类型。在Hibernate 5中通过自定义AbstractSingleColumnStandardBasicType结合TypeContributor实现了需求，但Hibernate 6中TypeContributor已过时，尝试AttributeConverter时出现冲突且无法生效，目前尝试@JavaTypeRegistration但不清楚如何实现自定义JavaType。

正确实现方案 #

你的方向是对的，继承DateJavaType是最优选择，无需大量复制原有代码，只需调整JDBC值到实体属性的转换逻辑，确保返回java.util.Date即可。

步骤1：自定义JavaType实现 #

继承DateJavaType，重写resolve方法（负责将JDBC层的日期类型转换为实体属性），在方法内将java.sql.Timestamp、java.sql.Date等类型统一转换为java.util.Date：

public class UtilDateJavaType extends DateJavaType {

    @Override
    public Date resolve(Object jdbcValue, SharedSessionContractImplementor session, Object owner) {
        if (jdbcValue == null) {
            return null;
        }
        // 将各类JDBC日期类型转换为java.util.Date，仅保留毫秒精度
        if (jdbcValue instanceof java.sql.Timestamp timestamp) {
            return new Date(timestamp.getTime());
        } else if (jdbcValue instanceof java.sql.Date sqlDate) {
            return new Date(sqlDate.getTime());
        } else if (jdbcValue instanceof java.sql.Time sqlTime) {
            return new Date(sqlTime.getTime());
        }
        return super.resolve(jdbcValue, session, owner);
    }
}

步骤2：全局注册自定义JavaType #

使用@JavaTypeRegistration注解全局注册该类型，Hibernate会自动为所有映射到java.util.Date的属性应用此类型，同时保留@Temporal注解对精度的控制：

@JavaTypeRegistration(
    javaType = java.util.Date.class,
    descriptorClass = UtilDateJavaType.class
)
public class UtilDateTypeRegistration {
    // 仅作为注册载体，无需额外代码
}

为什么不使用AttributeConverter？ #

AttributeConverter无法区分@Temporal(DATE)和@Temporal(TIMESTAMP)的场景——两个转换器都针对java.util.Date，Hibernate无法判断何时使用哪一个，全局自动应用会直接导致冲突。而继承DateJavaType可以保留原有的@Temporal精度逻辑，仅修改最终返回的实体属性类型。

效果验证 #

• 标注@Temporal(TIMESTAMP)的属性：Hibernate仍以TIMESTAMP类型与数据库交互，查询返回时自动将java.sql.Timestamp转换为java.util.Date（丢弃纳秒精度）。
• 标注@Temporal(DATE)的属性：以DATE类型与数据库交互，返回java.util.Date类型。
• 实体中始终持有java.util.Date，彻底避免了不同日期类型间的equals兼容性问题。

替代方案（细粒度控制场景） #

如果需要针对不同精度做更细致的定制，也可以继承AbstractTemporalJavaType<Date>，但需要实现getTemporalPrecision及对应转换逻辑，代码量会比继承DateJavaType更多，因此优先推荐前者。

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