Docker 容器时区错 8 小时:3 个坑

上周上线 Spring Boot 服务,报表时间整体偏移 8 小时。docker exec 进容器 date 显示 UTC,宿主机却是 CST,时间戳全偏。记三个坑。

先看现象

docker exec -it myapp date

输出 Fri Oct 30 02:11:00 UTC 2026,宿主机却是 CST。再 cat /etc/timezone 写着 Etc/UTC,默认 UTC。

第一个坑:只设 TZ 环境变量没用

很多人第一招 docker run 加 -e TZ=Asia/Shanghai,我也试了,重建再 date 还是 UTC。根因是基础镜像 openjdk:17-jdk-slim 没有 /usr/share/zoneinfo,TZ 指向的路径不存在,glibc 回退 UTC。老版本 JVM、C 库、cron 读 /etc/localtime 不认 TZ,只设环境变量等于没改。

第二个坑:装 tzdata 时构建卡死

补时区得在 Dockerfile 装 tzdata。我先写 RUN apt-get install -y tzdata,docker build 直接卡死。查了才知道 tzdata 安装会弹交互界面,docker build 没终端就一直等。正确写法先关交互:

ENV DEBIAN_FRONTEND=noninteractive

RUN apt-get update && apt-get install -y tzdata && \

ln -snf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \

写入 /etc/timezone 内容为 Asia/Shanghai && \

dpkg-reconfigure --frontend noninteractive tzdata && \

rm -rf /var/lib/apt/lists

关键三步:装包、软链、写 /etc/timezone,少一步部分工具仍读错。

第三个坑:Alpine 镜像命令不一样

另一个服务用 alpine:3.18,照搬 apt 命令直接报 command not found。Alpine 是 apk 包管理,得换:

RUN apk add --no-cache tzdata && \

cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \

写入 /etc/timezone 内容为 Asia/Shanghai

apk 没有 dpkg-reconfigure,逻辑一样但命令全变。漏了 --no-cache 镜像多一层缓存。

我的根治做法

现在新镜像我都在 Dockerfile 写死时区。老容器临时救火可以:

docker run -e TZ=Asia/Shanghai -v /etc/localtime:/etc/localtime:ro myapp

挂载宿主机 localtime 进去,date 立刻变对。但这是应急,重建又回 UTC,最终改 Dockerfile。k8s 在 Pod 的 env 加 TZ=Asia/Shanghai 效果等同。

验证:改完 docker exec 进去 date 变 CST、cat /etc/timezone 是 Asia/Shanghai,日志时间戳就正常。下一篇写 Java 层强制用中国时区,你踩过的坑下篇写你最想看的。

相关推荐
无足鸟ICT19 小时前
【RHCA+】sosreport(收集诊断文档)
linux·运维·服务器
IT大白鼠20 小时前
当 AI 开始自动化渗透:FBI ARTEX 警报的防守对策
运维·人工智能·自动化
Decay__20 小时前
SQLServer 运维自动化平台 —— PowerShell + SQL Agent 作业:部署、监控、巡检、告警、工单闭环一体化
运维·数据库·sql·mysql·架构
A-刘晨阳21 小时前
K8S 二进制集群搭建(一主两从)v1.37.2 版本
运维·云原生·容器·kubernetes·calico·nerdctl
tonydf21 小时前
没完了,Nginx又报新漏洞!
运维·nginx
瑞雪兆丰年兮1 天前
Linux零基础快速入门-第二章 Linux基础命令
linux·运维·服务器
lambo mercy1 天前
01初识docker
运维·docker·容器
时间的拾荒人1 天前
Docker 容器、仓库与数据管理实战
docker·容器·eureka
时间的拾荒人1 天前
Docker 入门实战:从核心概念、安装配置到镜像操作与 Dockerfile 定制
运维·docker·容器·eureka
光电笑映1 天前
TCP 为什么可靠?从三次握手、滑动窗口到拥塞控制全面拆解(上)
运维·服务器·网络·udp