Docker 容器时区和宿主机不一致导致日志时间错乱怎么办？

Question

仓乃文 · Accepted Answer

Docker 容器默认使用 UTC 时区，而国内业务通常需要北京时间（UTC+8）。容器内时间和宿主机差 8 小时，导致日志时间戳、定时任务、数据库记录全部错乱，是初学者最常忽略的问题。

问题复现：
```bash
# 宿主机时间
date
# 2026-05-09 14:30:00 CST

# 容器内时间
docker run --rm alpine date
# 2026-05-09 06:30:00 UTC  ← 差了 8 小时！
```

修复方案：
```bash
# 方案 1：挂载宿主机时区文件（最简单）
docker run -v /etc/localtime:/etc/localtime:ro \
           -v /etc/timezone:/etc/timezone:ro \
           nginx

# 方案 2：设置 TZ 环境变量（推荐，最通用）
docker run -e TZ=Asia/Shanghai nginx

# 方案 3：Dockerfile 中设置（构建时固化）
# 在 Dockerfile 中添加：
# ENV TZ=Asia/Shanghai
# RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
```

Docker Compose 配置：
```yaml
services:
  app:
    image: nginx
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - /etc/localtime:/etc/localtime:ro
```

不同语言的额外处理：
```bash
# Java 应用：JVM 有自己的时区设置
docker run -e TZ=Asia/Shanghai \
  openjdk java -Duser.timezone=Asia/Shanghai -jar app.jar

# Python 应用：部分库依赖 TZ 变量
import os
os.environ["TZ"] = "Asia/Shanghai"

# Node.js 应用：moment/dayjs 默认读系统时区
# 设置 TZ 环境变量即可
```

补充说明：
- Alpine 镜像没有预装 tzdata，需要先安装：RUN apk add --no-cache tzdata
- 方案 1 和方案 2 可以同时使用，双保险
- 规则：所有容器必须设置时区，不要依赖默认值
- 数据库容器时区尤其重要，否则时间字段存储和查询都会出错