JDBC URL中zeroDateTimeBehavior=convertToNull在Hibernate中失效问题

看起来你遇到的问题是JDBC URL里配置的zeroDateTimeBehavior=convertToNull没有按预期把数据库中的0000-00-00日期转为null，反而得到了错误的00002-10-02日期。这大概率是Hibernate的日期处理逻辑、驱动版本兼容性或者配置传递的问题，下面是几个排查和解决的方向：

1. 确认JDBC URL参数确实被应用到连接上 #

有时候配置文件中的URL可能没有被正确加载，或者被其他配置覆盖了：

• 开启Hibernate的SQL日志（设置hibernate.show_sql=true和hibernate.format_sql=true），观察连接建立时的参数是否包含zeroDateTimeBehavior=convertToNull；
• 如果使用了连接池（比如HikariCP），确保连接池的jdbcUrl属性完整包含该参数，避免在其他配置节点重复定义URL导致覆盖。

2. 检查Hibernate与MariaDB驱动的版本兼容性 #

不同版本的Hibernate和MariaDB Connector/J之间可能存在兼容性问题，导致驱动参数无法被正确处理：

• Hibernate 6.x建议搭配MariaDB Connector/J 3.0+；Hibernate 5.x可以搭配Connector/J 2.7+；
• 旧版本驱动可能存在zeroDateTimeBehavior处理bug，尝试升级到最新稳定版的MariaDB驱动，验证问题是否解决。

3. 调整实体类的日期字段映射 #

Java的java.util.Date本身对零日期的处理存在缺陷，换用更适配的日期类型或调整注解配置：

• 使用Java 8+日期类型：将实体类中的Date字段替换为LocalDate，Hibernate 5.2+原生支持该类型，它不会接受无效的零日期，配合驱动参数会正确转为null；
• 显式指定列默认值：如果需要保留java.util.Date，在实体字段上添加@Column(columnDefinition = "DATE DEFAULT NULL")，让Hibernate生成的表默认值为null而非0000-00-00，从根源避免零日期插入。示例代码：

  @Column(name = "date_column", columnDefinition = "DATE DEFAULT NULL")
  private Date dateField;
  

4. 配置Hibernate的日期处理策略 #

Hibernate自身的日期转换逻辑可能覆盖驱动参数，尝试添加以下配置强制正确处理无效日期：

• 在配置文件中添加：

  hibernate.jdbc.time_zone=UTC
  hibernate.type.preferred_instant_jdbc_type=TIMESTAMP
  

• 针对日期字段，使用@Type注解指定自定义类型处理：

  @Type(type = "org.hibernate.type.LocalDateType")
  private LocalDate dateField;
  

5. 直接修改数据库表结构 #

如果以上方法都无效，可以手动修改数据库表：将日期列的默认值从0000-00-00改为NULL，并允许该列为空。这样插入未指定日期的记录时，数据库会自动插入null，自然避免后续的读取问题。

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