最可靠方式是安装时区数据包+配置/etc/localtime+设置tz环境变量三者结合：debian/ubuntu需安装tzdata并软链时区文件；alpine需安装tzdata-alpine并复制时区文件；tz仅作兼容性补充。
在 Docker 中统一设置时区，最可靠的方式不是依赖环境变量（如 TZ）单独生效，而是通过安装时区数据包 + 正确配置系统时区文件 + 可选设置环境变量三者结合实现。多数基础镜像（如 debian、ubuntu、alpine）默认不预装时区数据或未正确链接 /etc/localtime，仅设 TZ 环境变量对很多程序（如 Java、PostgreSQL、systemd 服务、部分 C 库时间函数）无效。
Debian/Ubuntu 镜像：安装 tzdata 并配置 /etc/localtime
这类镜像需显式安装 tzdata 包，并使用 dpkg-reconfigure 或直接复制时区文件：
- 在
Dockerfile中添加（以 Asia/Shanghai 为例）：
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
echo "Asia/Shanghai" > /etc/timezone
注意：dpkg-reconfigure -f noninteractive tzdata 在 CI 环境中可能因缺少交互支持失败，直接写文件更稳定。
Alpine 镜像：安装 tzdata-alpine 并软链
Alpine 使用轻量级时区数据包 tzdata（实际是 tzdata-alpine），无需交互配置：
- RUN apk add --no-cache tzdata && \
cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
echo "Asia/Shanghai" > /etc/timezone
Alpine 的 /etc/timezone 文件虽非所有程序读取，但配合 /etc/localtime 软链可覆盖绝大多数场景（包括 Go、Python datetime、Node.js Date）。
统一设置 TZ 环境变量作为补充
环境变量 TZ 对部分语言运行时有效（如 Java、PHP、某些 Shell 命令），建议与系统时区同步设置：
- ENV TZ=Asia/Shanghai
- 该行应放在时区文件配置之后，确保逻辑一致
- Java 应用会自动读取
TZ；若已设/etc/localtime，此项为冗余但无害，增强兼容性
验证时区是否生效
构建镜像后，进入容器执行以下命令确认：
- date —— 输出应为本地时区时间
- cat /etc/timezone 和 ls -l /etc/localtime —— 检查路径和内容是否匹配目标时区
- 对关键应用做运行时验证（如 Java 中
System.out.println(new Date());）
不复杂但容易忽略的是：只设 TZ 环境变量而未配置系统时区文件，会导致底层 C 函数（localtime()）仍返回 UTC 时间，引发日志、数据库时间戳、定时任务等错乱。
