库里时间差 8 小时:MySQL 时区、TIMESTAMP 与连接参数的错位
同一行数据客户端查是对的、应用读出来差 8 小时,多半不是数据坏了。本文讲清 DATETIME 与 TIMESTAMP 的存储差异、三层时区谁说了算,并给出用一条查询定位、用连接参数统一的落地做法。
同一行数据,用数据库客户端查出来是对的,在应用里读出来差 8 小时——这几乎总是 TIMESTAMP 的会话时区转换和连接串参数没对齐,而不是数据被写坏了。
DATETIME 存字面量,TIMESTAMP 存时间点
两者的区别决定了排查方向:
- DATETIME 把 '2026-11-21 10:00:00' 原样存下来,没有时区概念,读出来还是这串字面量,会话时区怎么变它都不变。
- TIMESTAMP 内部存的是 UTC 时间点(纪元秒)。写入时按当前会话的 time_zone 把字面量折算成 UTC,读取时再按会话时区折回来。
所以同一个 TIMESTAMP 字段,在不同会话里读出的字面量可以不同。这既是它的价值(跨时区自动对齐),也是绝大多数时区事故的根源。
三层时区,谁最后说了算
一次读写会经过三层时区,优先级从低到高:
- 服务器系统时区(@@system_time_zone),my.cnf 里 default-time-zone 没配时,global 就是 SYSTEM,即沿用操作系统时区。
- 全局与会话(@@global.time_zone / @@session.time_zone)。客户端建连时可以自己 SET 会话时区,覆盖全局值。
- 驱动参数。JDBC 的 connectionTimeZone(老版本叫 serverTimezone)决定建连后是否把会话时区设成指定值,以及客户端如何解析服务端返回的时间。
应用跑在容器里时最容易出问题:容器基础镜像的时区通常是 UTC,JVM 默认时区跟着是 UTC,驱动按 UTC 去解释服务端返回的 +08:00 数据,于是整批字段偏移 8 小时。
定位与统一
先用一条 SHOW 语句把全局值与会话值并排打出来:
SHOW VARIABLES LIKE '%time_zone%';
SELECT NOW();
把这条语句在数据库客户端和应用连接池里各执行一次,两边结果不一致,问题就在会话层。再把 NOW() 与 SYSDATE() 对比一下,能顺便看出语句开始时刻与执行时刻的差异。
统一策略有两条,选一条坚持到底即可:
- 存储层统一 UTC:所有连接强制 connectionTimeZone=UTC,展示层按用户时区格式化。跨时区业务推荐这条。
- 全程固定 +08:00:连接参数、服务器、容器时区都钉死,不允许任何一层漂移。单地区业务够用,成本更低。
spring:
datasource:
url: jdbc:mysql://db:3306/app
hikari:
connection-init-sql: SET time_zone = '+08:00'
用连接池的初始化 SQL 显式设置会话时区,比依赖驱动自动推导更可控:无论驱动版本怎么升,建连后的会话时区都是确定的,排查时少一个变量。
适用边界与常见坑
- 改 global 不影响已建立的连接。连接池里的老连接还带着旧会话时区,必须重启应用或让连接池主动回收,否则会出现「部分请求正常、部分偏移」的诡异现象。
- 优先用命名时区(Asia/Shanghai)而不是偏移量(+08:00)。国内不用夏令时,但代码被复用到别的地区就会错,而且偏移量写法在 MySQL 里对部分时区名无效。
- DATETIME 完全不受会话时区影响。表里两种类型混用,就会出现「有的字段对、有的差 8 小时」,排查第一步永远是先看字段类型。
- 备份恢复时留意时区选项。导出与导入两端会话时区不一致,整表数据会整体偏移,而且不会报错。
正在加载评论…