Files
usdt/docs/timezone-fix.md
T
2026-11-02 02:20:47 -05:00

2.6 KiB

数据库时间与服务器相差8小时的修复

根因与统一规则

旧租赁实现将DATETIME(3)按UTC写入,而支付Date、日志和Jackson使用JVM本地时区,因此东八区服务器查看租赁原始记录会相差8小时。

修复后,租赁DATETIME使用服务器/JVM本地时间;SQL CURRENT_TIMESTAMP和MySQL连接会话采用相同时区。协议签名、链上毫秒时间戳及HTTP带Z的ISO时间仍表示真实时间点。

按用户要求,本次只修复代码,不修改历史记录;已移除历史数据迁移脚本、迁移标记逻辑及启动确认开关,启动无需配置RENT_LOCAL_TIME_STORAGE_READY。旧记录保持原值,不会自动加8小时。

修复范围

  • RentalValues统一本地时间写入及Timestamp/LocalDateTime读取。
  • 快照、节点心跳、订单调度、回收、任务期限、链上证明及历史保留截止时间使用统一转换。
  • 充值失效时间、提现交易时间与审核时间使用同一口径。
  • 历史采集/清理租约和worker到期判断使用CURRENT_TIMESTAMP。
  • 看板按本地自然日统计,timezone返回服务器时区;接口ISO时间保持真实时间点。
  • MySQL主从连接统一connectionTimeZone=LOCAL及forceConnectionTimeZoneToSession=true,消除驱动固定GMT+8与JVM时区不一致的问题。Connector/J使用8.0.30。
  • 七牛配置对象移除独立硬编码GMT+8的序列化设置,遵循JVM/Jackson时区。
  • 初始化DDL、实体字段说明、套餐种子及绑定维护SQL同步更新。

UTC 02:00核账和UTC 03:15历史清理是明确安排的定时执行时间,保持不变。JWT、HMAC时间戳、链上epoch毫秒和签名载荷不变。

部署与核对

部署更新后的服务及依赖lib(包括Connector/J 8.0.30),保持JVM时区与服务器业务时区一致。东八区示例:

java -Duser.timezone=GMT+08:00 -jar ruoyi-admin.jar

使用Asia/Shanghai等命名时区时,MySQL需要加载对应时区表,驱动会设置同一会话时区。运行期间不要改变JVM时区。

检查启动日志“数据库时间配置”,再核对新订单、快照更新时间与服务器当前时间。数据库会话可查询:

SELECT NOW(3), UTC_TIMESTAMP(3), @@session.time_zone, @@global.time_zone, @@system_time_zone;

接口ISO字符串仍可带Z,表示UTC格式的同一真实时间点,不表示数据库仍有8小时偏移。

验证范围

已在东八区执行后端回归,以及UTC、东八区、纽约时区的时间点往返、响应序列化、JDBC URL归一化和主从配置绑定测试。未操作生产数据库或执行真实链上广播。