WildFly与JPA时区异常：插入Instant时时间偏移问题

我之前也踩过类似的时区配置坑，给你梳理几个关键的排查和解决步骤，应该能搞定这个多2小时的问题：

• 强制Hibernate使用UTC时区
  光靠JVM的-Duser.timezone=UTC可能不够，Hibernate有自己独立的时区处理逻辑。在你的持久化配置文件（比如persistence.xml或者Spring的application.properties）里添加：

  hibernate.jdbc.time_zone=UTC
  

  这个配置会让Hibernate在处理Instant、ZonedDateTime等时间类型时，强制以UTC为基准做转换，避免和JVM时区产生冲突。

• 修正MariaDB连接串的时区参数
  数据库服务器的时区会直接影响最终存储的时间值。确保你的JDBC连接URL明确指定UTC时区：

  jdbc:mariadb://localhost:3306/your_database?serverTimezone=UTC
  

  同时登录MariaDB执行以下SQL，确认数据库本身的时区配置：

  SELECT @@global.time_zone, @@session.time_zone;
  

  如果结果不是UTC或者+00:00，需要修改数据库配置文件（Linux为my.cnf，Windows为my.ini），添加：

  default-time-zone = '+00:00'
  

  然后重启MariaDB服务。

• 确认WildFly的JVM时区真正生效
  有时候standalone.conf里的-Duser.timezone=UTC可能没被正确加载（比如用IDE启动WildFly时，IDE的运行参数优先级更高）。可以在代码里加一段调试代码，验证运行时的实际时区：

  System.out.println("当前JVM时区: " + TimeZone.getDefault().getID());
  System.out.println("Hibernate配置时区: " + entityManagerFactory.getProperties().get("hibernate.jdbc.time_zone"));
  

  如果输出不是UTC，检查IDE的运行配置里是否添加了-Duser.timezone=UTC参数，或者确保WildFly启动时确实读取了修改后的standalone.conf。

• 检查实体类的时间字段映射
  确保Instant类型的字段映射没有问题，Hibernate 5.2及以上版本原生支持Instant，不需要额外的@Temporal注解：

  @Column(name = "create_time")
  private Instant createTime;
  

  如果你用了自定义的属性转换器，一定要确认转换器没有错误地将UTC时间转换为系统时区。

另外，修改Windows系统时区只是临时的 workaround，生产环境不可能依赖这种方式，所以重点还是把JVM、Hibernate、数据库三层的时区都统一配置为UTC。

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