如何导入MySQL时区数据-mysql教程-PHP中文网

mysql时区表为空会导致now()、convert_tz()等函数静默退化为系统本地时间，引发跨时区时间错乱；需用mysql_tzinfo_to_sql工具导入系统zoneinfo数据，并严格校验iana时区名大小写与存在性。

如何导入mysql时区数据

MySQL 时区表为空怎么办

导入 MySQL 时区数据，本质是往 mysql 库的 time_zone* 表里填入标准时区规则。默认安装后这些表是空的，NOW()、CONVERT_TZ() 等函数就无法正确转换——不是报错，而是静默退化为系统本地时间，容易引发跨时区业务的时间错乱。

最直接的办法是用官方提供的 mysql_tzinfo_to_sql 工具生成 SQL 并导入，但它依赖系统级时区文件（如 /usr/share/zoneinfo），且不同操作系统路径和权限要求差异大。

Linux（如 Ubuntu/Debian）：通常已预装 tzdata 包，/usr/share/zoneinfo 存在，可直接运行 mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql
CentOS/RHEL：需先 yum install tzdata，再确认 /usr/share/zoneinfo 是否可读（SELinux 可能拦截，临时禁用或加策略）
macOS：系统不自带完整 zoneinfo，得手动下载或用 Homebrew 安装 tzdata（路径通常是 /opt/homebrew/share/zoneinfo）
Docker 官方镜像（如 mysql:8.0）：基础镜像不含 tzdata，必须在构建时 apt-get install -y tzdata 或挂载宿主机 zoneinfo 目录

导入后 `CONVERT_TZ()` 还返回 NULL

即使导入成功，CONVERT_TZ('2024-01-01 12:00:00', 'UTC', 'Asia/Shanghai') 仍可能返回 NULL，常见原因不是数据没导，而是时区名拼写或大小写不对。

MySQL 的时区名严格区分大小写，且只认 IANA 标准名（如 Asia/Shanghai），不接受 GMT+8、China Standard Time 或缩写 CST（它会当成美国中部时间）。

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

查已加载的时区：执行 SELECT name FROM mysql.time_zone_name;，确认 Asia/Shanghai 确实存在（注意不是 Asia/shanghai）
验证时区有效性：用 SELECT CONVERT_TZ(NOW(), '+00:00', 'Asia/Shanghai'); 测试，避免用模糊字符串
如果只用少数几个时区，可跳过全量导入，直接 INSERT 几条关键记录（比如 INSERT INTO mysql.time_zone SET time_zone_id=1, use_leap_seconds='N'; 再配 time_zone_transition），但需自己解析 tzdata 二进制格式，不推荐

MySQL 8.0+ 的 `--default-time-zone` 和时区表关系

--default-time-zone='+08:00' 或 --default-time-zone='Asia/Shanghai' 是启动参数，它只影响新连接的会话变量 time_zone，**不替代时区表**。哪怕设了 Asia/Shanghai，CONVERT_TZ() 依然需要时区表数据才能做带夏令时的精确转换。

设成固定偏移（如 +08:00）：跳过时区表依赖，但所有转换都按固定偏移算，无视夏令时（如美国东部时间会出错）
设成命名时区（如 Asia/Shanghai）：MySQL 启动时会尝试从时区表加载该时区规则；若表为空，它会 fallback 到系统本地时区，且不报错
线上环境建议：启动参数设 +00:00（强制 UTC），应用层统一处理时区转换，避免数据库成为时区逻辑中心

一键检查时区数据是否生效

别只看导入命令有没有报错，真正要验证的是函数行为是否符合预期。最简验证法：

SELECT 
  NOW() AS now_local,
  CONVERT_TZ(NOW(), '+00:00', 'Asia/Shanghai') AS utc_to_sh,
  CONVERT_TZ(NOW(), 'UTC', 'America/New_York') AS utc_to_ny,
  (SELECT COUNT(*) FROM mysql.time_zone_name) AS tz_count;

如果最后一列是 0，说明表空；如果前两列结果相同（即 utc_to_sh = now_local），大概率是 Asia/Shanghai 没加载成功或拼写错误；如果 utc_to_ny 是 NULL，说明 America/New_York 记录缺失——这时得回看导入日志里有没有 warning 提到“skipping”某个 zone。

时区数据不是“导一次就永久有效”，系统升级、MySQL 版本更新、甚至 mysql_upgrade 都可能清空或重置 mysql 库结构，生产环境得把导入步骤固化进部署流程，不能只靠初始化脚本跑一遍。