容器内 datetime.now() 返回 UTC 而非本地时间，根本原因是基础镜像（如 python:3.12-slim、alpine）默认未安装 tzdata 且未设置 TZ 环境变量，导致系统时区上下文缺失；实操需在构建阶段安装 tzdata、设 ENV TZ=Asia/Shanghai、软链 /etc/localtime 并写入 /etc/timezone，同时在 Docker Compose 或 K8s 中透传 TZ 和挂载 /etc/localtime。
容器内 datetime.now() 返回 UTC 而不是本地时间
这是最常见现象：脚本在宿主机上运行输出北京时间，一进容器就变成 UTC（慢 8 小时）。根本原因不是 Python 错了，而是容器没正确加载时区上下文——datetime.now() 默认读取系统时区，而多数基础镜像（如 python:3.12-slim、alpine）默认不带 tzdata，且未设置 TZ 环境变量。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 构建镜像时必须显式安装时区数据：
RUN apt-get update && apt-get install -y tzdata（Debian/Ubuntu）或RUN apk add --no-cache tzdata（Alpine） - 紧接着用环境变量固化时区：
ENV TZ=Asia/Shanghai，再执行软链和写入：RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo "$TZ" > /etc/timezone - 避免只靠
ENV TZ而不安装tzdata——Alpine 镜像里TZ只影响部分 C 库函数，datetime仍可能 fallback 到 UTC
挂载 /etc/localtime 后 time.time() 时间戳仍跳变
挂载能同步时间显示，但解决不了底层时钟漂移问题。NTP 在宿主机调整系统时钟时，容器内 time.time() 会直接反映跳变，导致日志倒序、定时任务错乱。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 挂载只读时区文件仍是必要操作：
-v /etc/localtime:/etc/localtime:ro，但它不解决单调性问题 - 代码中凡涉及时间间隔判断（如重试、超时），一律改用
time.monotonic()，它基于内核单调时钟，不受 NTP 调整影响 - 生成可读时间戳时，优先用
datetime.now(tz=timezone.utc)，而非datetime.now()——避免隐式依赖系统时区，也规避了本地化转换带来的不确定性
第三方库日志或数据库写入时间仍不对
很多库（如 logging、SQLAlchemy、celery）内部调用 time.localtime() 或直接读系统时区，你改了镜像配置，它们未必感知。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 强制
logging使用 UTC：logging.Formatter.converter = time.gmtime，防止 NTP 回拨造成日志时间倒流 - 数据库连接层显式指定时区：PostgreSQL 连接字符串加
?options=-c%20timezone%3DAsia%2FShanghai；MySQL 加?charset=utf8mb4&timezone=Asia%2FShanghai - 不要依赖
os.environ['TZ']动态修改——Python 启动后该变量只影响部分 C 函数，对已导入模块无效；必须在进程启动前设好
Docker Compose 或 Kubernetes 中漏掉时区配置
本地测试 OK，上线就出问题，往往是因为编排文件里没透传时区设置。K8s Pod 默认不继承节点时区，Compose 默认也不挂载主机文件。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- Docker Compose 中必须同时写两处：
environment: - TZ=Asia/Shanghai和volumes: - /etc/localtime:/etc/localtime:ro - Kubernetes 的 Deployment 中，
env字段设TZ，再加volumeMounts挂载/etc/localtime；注意hostPath类型需为FileOrCreate或File，否则挂载失败静默忽略 - 别信“用了 Alpine 就轻量”——Alpine 默认无
tzdata，哪怕写了TZ环境变量，datetime.now()仍返回 UTC，必须apk add tzdata
真正麻烦的不是设一次时区，而是确保从镜像构建、容器启动、到每个 Python 模块内部，所有时间相关路径都走同一套时区逻辑。中间任一环脱节（比如忘了装 tzdata，或 K8s YAML 漏了 volumeMounts），就会在某个角落突然冒出一个 UTC 时间戳。
