借助HugSQL解决Clojure操作MySQL DATETIME时区偏移问题

我之前也踩过类似的时区坑，咱们一步步拆解问题根源，然后把它搞定：

问题根源分析 #

MySQL的DATETIME类型不存储时区信息，它只保存字面的日期时间值。你用(t/now)拿到的是UTC时间，但插入后变成+2小时，大概率是这两个环节的时区不匹配：

• 你的MySQL服务器时区设置为UTC+2（比如欧洲中部时间这类时区）
• JDBC驱动在传输时间时，默认用JVM时区或数据库服务器时区做了转换，导致UTC时间被自动偏移成了服务器时区的时间

具体解决方案 #

1. 先确认MySQL服务器的时区配置 #

先登录MySQL执行这条命令，查看当前时区设置：

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

如果结果显示是SYSTEM，说明它跟着操作系统时区走，很可能就是UTC+2。如果想让数据库统一用UTC存储时间，可以修改MySQL配置文件（比如my.cnf或my.ini），添加如下配置后重启服务：

[mysqld]
default-time-zone = '+00:00'

2. 配置JDBC连接字符串明确指定时区 #

这是最直接可靠的方式，强制JDBC驱动用UTC处理时间转换。把你的数据库连接配置改成这样：

(def db {:dbtype "mysql"
         :dbname "your_database_name"
         :user "your_username"
         :password "your_password"
         :serverTimezone "UTC"})

或者用传统的URL格式：

(def db {:connection-uri "jdbc:mysql://localhost:3306/your_database?serverTimezone=UTC&useSSL=false"})

这样驱动就会把你传入的UTC时间原封不动传给数据库，不会做额外的时区偏移。

3. 用clj-time.jdbc工具函数优化时间转换 #

clj-time专门提供了clj-time.jdbc库来处理JDBC和clj-time DateTime对象的转换，避免手动处理时区出错。插入时可以用这个库的插入函数：

(require '[clj-time.jdbc :as jdbc-time]
         '[clj-time.core :as t])

(jdbc-time/insert! db :your_target_table {:date-field (t/now)})

这个函数会自动把带时区的DateTime对象转换成JDBC能正确识别的格式，配合连接字符串的时区设置，就能保证时间存储准确。

4. 查询时的时区转换（可选） #

如果后续需要把数据库里的UTC时间转成业务需要的时区，可以用clj-time的时区转换函数：

(defn utc-to-local [utc-time]
  (t/to-time-zone utc-time (t/time-zone-for-offset +2))) ; 转成UTC+2时区

总结 #

核心思路就是让JDBC驱动、数据库服务器、你的代码在时间处理上统一使用同一个时区（推荐UTC），这样就不会出现莫名其妙的时间偏移了。

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