python在docker中显示utc时间，根本原因是tz环境变量、/etc/localtime（需硬链接或复制，非软链接）、tzdata包三者缺一不可；alpine等精简镜像默认不装tzdata且不支持软链接时区，须run cp /usr/share/zoneinfo/asia/shanghai /etc/localtime并安装tzdata。
Python在Docker容器里显示UTC时间，不是代码写错了，而是容器根本没正确加载时区——TZ环境变量、/etc/localtime软链接、tzdata包三者缺一不可。
Python 3.9+ 依赖 TZ 环境变量，但 slim 镜像默认不装 tzdata
Python 3.9 开始才原生读取 TZ 变量来设置 datetime.timezone 的默认行为；低于该版本（如 3.8）即使设了 TZ=Asia/Shanghai，datetime.now() 仍返回无时区的本地时间（即系统认为的“本地”，但实际是 UTC）。更关键的是：Debian/Ubuntu slim、Alpine 等精简镜像默认不带 tzdata 包，此时 zdump -v Asia/Shanghai 会直接报错 “no time zone file”，TZ 变量形同虚设。
- 验证方式：
docker exec -it myapp python3 -c "import datetime; print(datetime.datetime.now())"—— 若输出无+08:00且和宿主机差8小时，大概率是tzdata缺失 - Debian/Ubuntu：
RUN apt-get update && apt-get install -y tzdata && rm -rf /var/lib/apt/lists/* - Alpine：
RUN apk add --no-cache tzdata - 注意：
tzdata安装后无需额外dpkg-reconfigure，只要TZ和/etc/localtime同步即可生效
/etc/localtime 必须是硬链接或副本，软链接挂载在 Alpine 中会失效
很多教程教你在 Dockerfile 里写 RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime，这在 Debian/Ubuntu 上能用，但在 Alpine 上失败——因为 Alpine 的 /usr/share/zoneinfo/Asia/Shanghai 是个指向 ../posix/Asia/Shanghai 的软链接，而 /etc/localtime 若也用软链接指向它，glibc 在解析时会丢弃路径，最终 fallback 到 UTC。真正可靠的方式是复制文件或用硬链接：
- Debian/Ubuntu 推荐：
RUN ln -snf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo "Asia/Shanghai" > /etc/timezone - Alpine 必须用复制：
RUN cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime（不能用ln -s） - 运行时挂载也要小心：
-v /etc/localtime:/etc/localtime:ro在 Alpine 容器中可能因源文件是软链接而断裂，不如构建时固化
不同启动方式下 TZ 的传递优先级与陷阱
TZ 环境变量必须被 Python 进程实际继承。常见失效场景包括：
- 用
docker run -e TZ=Asia/Shanghai启动，但基础镜像没装tzdata→ 变量存在，但无数据支撑 - 在
docker-compose.yml里写了environment: - TZ=Asia/Shanghai，但用了entrypoint覆盖了 shell，导致变量未传入 Python 进程（例如entrypoint: ["python", "app.py"]不会自动继承env） - 使用 supervisord 或 cron 启动 Python，需显式在配置中声明
environment=，否则子进程收不到TZ - Python 代码里手动调用
time.tzset()（仅 Unix）可强制重载TZ，但前提是tzdata已安装且TZ已设好
最稳妥的组合是：构建时安装 tzdata + 复制或硬链接 /etc/localtime + 设置 ENV TZ=Asia/Shanghai。运行时靠 TZ 触发 Python 行为，靠 /etc/localtime 支撑系统级调用（如 date 命令、strftime），靠 tzdata 提供底层数据。三者任一缺失，都可能在某个环节掉链子——尤其是跨镜像类型部署时，Alpine 和 Debian 对软链接的处理差异最容易被忽略。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
