Docker 容器内时区错位排查：从 UTC 到 CST 与宿主机时间同步实操

将一个 Spring Boot / Node.js 镜像打包部署后，查看业务打印的日志发现时间总是不对劲，比如当前北京时间是 16:00，日志里打印的时间却是 08:00，整整相差 8 个小时。

一、原因定位

大部分官方基础镜像（如 Alpine、Ubuntu、Debian）默认采用 UTC（世界协调时）时区，而我们国内采用的是东八区 CST（UTC+8）。

进入容器运行 date 验证：

docker exec -it my_container date
Mon Oct 28 08:24:12 UTC 2026

确认容器内确实使用的是 UTC 时区。

二、不同场景下的修复方案

1. 快速临时方案：挂载宿主机 localtime

在 docker run 或 docker-compose.yml 中挂载宿主机的时区文件：

docker run -d \
  -v /etc/localtime:/etc/localtime:ro \
  -v /etc/timezone:/etc/timezone:ro \
  --name my_app my_image:latest

2. 根本解决：在 Dockerfile 构建阶段固化时区

针对 Alpine 镜像：

FROM alpine:3.18
RUN apk add --no-cache tzdata \
    && cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime \
    && echo "Asia/Shanghai" > /etc/timezone \
    && apk del tzdata

针对 Debian/Ubuntu 镜像：

FROM debian:bullseye-slim
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

重新构建部署后再次执行 date，时区正确显示为 CST，日志与数据库时间恢复同步。