日志时间总差 8 小时?一次容器时区排查实录
现象
容器里打出来的业务日志,时间总比北京时间少 8 小时。宿主机 date 正常,容器内 date 也“正常”——只是它跑在 UTC 上。
一、先分清是时区错还是时间错
两条命令足够区分:
date # 容器内当前时间
date -u # 容器内 UTC 时间
如果 date 与 date -u 完全一致,说明容器跑在 UTC;如果两者都偏离真实时间且互相也对不上,那是时钟同步问题(NTP),方向完全不同。这次是前者。
二、容器的时区从哪来
Linux 决定本地时间只靠两样东西:/etc/localtime 指向的时区文件,以及 TZ 环境变量。容器不“继承”宿主机时区,它只共享内核的 UTC 时钟,根文件系统是镜像自己的。
ls -l /etc/localtime
cat /etc/timezone 2>/dev/null
echo $TZ
我们这次的镜像基于 alpine,localtime 指向 UTC,而且镜像里没有装 tzdata。于是即使 docker run 时加了 -e TZ=Asia/Shanghai,musl 也找不到时区数据库,只能退回 UTC。
三、三种改法
1)单容器临时:挂载 + 环境变量
docker run -e TZ=Asia/Shanghai -v /etc/localtime:/etc/localtime:ro -v /etc/timezone:/etc/timezone:ro myapp:latest
只挂 localtime 就能让 date 正确,但部分 Debian 系工具还会读 /etc/timezone,一起挂更稳。
2)长期做法:写进 Dockerfile
FROM alpine:3.20
RUN apk add --no-cache tzdata && cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo "Asia/Shanghai" > /etc/timezone
ENV TZ=Asia/Shanghai
Debian/Ubuntu 基础镜像则用 apt 装 tzdata,再软链 /usr/share/zoneinfo/Asia/Shanghai 到 /etc/localtime。关键顺序是先装 tzdata,再设 TZ,反了仍然无效。
3)Kubernetes
用 hostPath 把节点的 localtime 挂进容器最省事;不想依赖宿主机,就把 tzdata 打进镜像只设 TZ。注意 hostPath 挂单文件在节点缺文件时会让 Pod 起不来,必要时加 type: File 明确语义。
四、时区对了,日志还是不对
- JVM 启动时缓存时区。只改环境变量不重启进程等于没改;验证时可用
-Duser.timezone=Asia/Shanghai显式指定。 - MySQL 连接串里的 serverTimezone 只影响 JDBC 如何解释时间戳,不会改服务端存的值。服务端容器要用
--default-time-zone=+08:00,想按名字写还得先导入时区表。
五、验收标准
- docker exec 进容器,date 与 date -u 相差 8 小时;
- 应用日志里同一事件的时间与容器 date 一致;
- 跨零点的定时任务、按天聚合的统计不再整体偏移 8 小时。
时区问题的根因几乎只有一个:容器只共享内核时钟,不共享宿主机的时区配置。把 tzdata 备齐、localtime 指对、TZ 显式写上,再确认进程真的重启过,这类“日志早 8 小时”的怪现象就不会再出现。
- 点赞
- 收藏
- 关注作者
评论(0)