如何在H2数据库中正确存储LocalDateTime与LocalDate？时区异常排查

一、正确存储方式 #

LocalDateTime #

直接使用H2的TIMESTAMP WITHOUT TIME ZONE类型（H2 1.4.197及以上版本支持），该类型存储不带时区的本地时间，不会随JVM时区变化而转换。若使用旧版H2（如1.4.196），可暂用TIMESTAMP类型，但需配合时区参数规避转换问题。

LocalDate #

使用H2的DATE类型，该类型专门存储年-月-日信息，完全独立于时区，不会出现时区相关的转换异常。

二、时区异常原因及解决 #

异常原因 #

你遇到的问题是H2 1.4.196版本在MV_STORE=FALSE模式下的TIMESTAMP类型时区处理bug：

• 插入时，H2会将无时区的时间字符串解析为当前JVM时区的时间，但夏令时切换期间的时区偏移计算错误；
• 切换JVM时区读取时，存储的UTC毫秒数转换为新时区时间时，夏令时的偏移未被正确应用，导致5月1日（多伦多夏令时，UTC-4）的时间出现1小时偏差，而1月1日（冬令时，UTC-5）无偏差。

解决方法 #

1. 升级H2版本：升级到1.4.197及以上，新版TIMESTAMP默认是TIMESTAMP WITHOUT TIME ZONE，存储原始本地时间，彻底避免时区转换问题。
2. 统一JVM时区：所有Java进程启动时指定相同的user.timezone（如UTC），命令示例：

   java -Duser.timezone=UTC -cp h2*.jar org.h2.tools.Console
   

3. JDBC URL指定时区：在连接URL中添加TIMEZONE=UTC，强制H2使用UTC处理时间转换，示例：

   jdbc:h2:~/mydb;DATABASE_TO_UPPER=FALSE;DB_CLOSE_DELAY=-1;LOCK_TIMEOUT=60000;CACHE_SIZE=16384;AUTO_SERVER=TRUE;MV_STORE=FALSE;MVCC=FALSE;TIMEZONE=UTC
   

4. 明确字段类型：若无法升级，创建表时尝试使用TIMESTAMP WITHOUT TIME ZONE（部分旧版H2支持）：

   CREATE TABLE foo (  
      time TIMESTAMP WITHOUT TIME ZONE NULL 
   );
   

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