企业官网建设流程全解析

上周上线 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 层强制用中国时区，你踩过的坑下篇写你最想看的。