容器里时间差 8 小时（date 显示 UTC）/ 中文乱码（UnicodeEncodeError）

你会遇到什么

容器里 date 显示 UTC，跟宿主机差 8 小时；照着教程在 compose/docker run 里加了 -e TZ=Asia/Shanghai，重启容器后还是 UTC；或者程序打印中文直接报 UnicodeEncodeError: 'ascii' codec can't encode characters，日志里中文全是乱码/问号。

容器默认 UTC、默认 C locale，基础镜像还经常缺时区数据——这两个坑是容器部署的高频开场白。

本文路径：快速修复（两条命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

Docker 镜像基于 Linux 的默认配置：时区 = UTC，locale = C。date 读的是 /etc/localtime（或 TZ 环境变量 + zoneinfo），不是宿主机的时区——容器不会继承宿主机时区。

TZ 生效分两层：环境变量 TZ 只是告诉 libc「去 zoneinfo 找哪个时区」，如果镜像里没有 /usr/share/zoneinfo/（实测 alpine 基础镜像连这个目录都没有），TZ=Asia/Shanghai 就静默无效、仍然 UTC——这是「设了 TZ 没用」的头号原因。

两个替代路径：① 装 tzdata（alpine：apk add tzdata；Debian 系镜像通常已自带，直接 -e TZ=Asia/Shanghai 就生效）；② 不依赖 zoneinfo 的 POSIX TZ 字符串（-e TZ=UTC-8 = 东八区，符号与直觉相反，实测 23:09 与宿主机 CST 一致）。

中文乱码同理分两层：容器内程序按 ASCII/系统编码输出（Python 在 C locale 下默认自动 UTF-8——PEP 540，实测能正常打印中文；

但被 PYTHONIOENCODING=ascii 强制后立刻 UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-3: ordinal not in range(128)，实测原文）；

以及查看终端编码不匹配（容器输出 UTF-8 字节，Windows 控制台按 GBK 解码 → 显示乱码，与容器无关）。确定性推论：TZ 不生效先 docker run --rm <镜像> ls /usr/share/zoneinfo 看有没有时区数据；UnicodeEncodeError 先看环境变量里有没有 PYTHONIOENCODING/LANG 把编码锁死。

一步步来

1. 确认时区差在哪 — 必做

docker run --rm alpine date          # UTC = 没生效
docker run --rm alpine ls /usr/share/zoneinfo   # No such file = 镜像没 tzdata

2. 按镜像类型选修复 — 按诊断

• Debian 系（ubuntu/debian/python:slim 等）：自带 zoneinfo，-e TZ=Asia/Shanghai 直接生效；
• alpine 系：先 apk add --no-cache tzdata（Dockerfile 里装好，重构建），再 -e TZ=Asia/Shanghai；不想装就 -e TZ=UTC-8（POSIX，符号相反）；
• 已有容器：改环境变量后必须重建容器（docker compose up -d --force-recreate 或重新 docker run）；docker restart 用的是创建时的 env，改 env 不生效。

3. 排查中文乱码 — 按诊断

# 容器内确认 Python 实际输出编码
docker run --rm your-python-image python3 -c "import sys; print(sys.stdout.encoding)"
# utf-8 = 正常；ascii = 被环境变量锁死

修法优先级：PYTHONUTF8=1（全局）→ PYTHONIOENCODING=utf-8（stdout/stderr）→ LANG=C.UTF-8（locale）。注意 PYTHONUTF8=1 不覆盖显式 PYTHONIOENCODING=ascii（实测仍报错），必须把后者直接改成 utf-8。

4. 查看侧乱码（日志/终端） — 按场景

容器输出没问题但 Windows 终端/旧编辑器显示乱码：把终端切到 UTF-8（PowerShell：chcp 65001；VS Code 右下角选 UTF-8），这是显示层问题，改容器没用。

怎么确认修好了

docker run --rm -e TZ=Asia/Shanghai <镜像> date 与宿主机 date 小时一致；python3 -c "import sys; print(sys.stdout.encoding)" 输出 utf-8；带中文的程序输出正常显示。

其它环境的表现

症状

# 时区
$ docker run --rm -e TZ=Asia/Shanghai alpine date
Mon Aug 31 15:09:18 UTC 2026        # 还是 UTC！
$ docker run --rm alpine ls /usr/share/zoneinfo
ls: /usr/share/zoneinfo: No such file or directory

# 乱码
$ docker run --rm -e PYTHONIOENCODING=ascii python:3.12-alpine python3 -c "print('中文测试')"
UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-3: ordinal not in range(128)

特征：TZ=Asia/Shanghai 设了但 date 仍 UTC；镜像缺 zoneinfo；程序输出中文抛 ascii 编码错误。

原因

容器默认 UTC 且不继承宿主机时区；alpine 等基础镜像缺 /usr/share/zoneinfo，TZ=Asia/Shanghai 无效。中文乱码=容器内程序被锁成 ASCII/非 UTF-8 输出（UnicodeEncodeError），或查看终端编码与 UTF-8 不匹配（显示乱码）。

解法

1. 时区：Debian 系 -e TZ=Asia/Shanghai；alpine 装 tzdata 或临时 -e TZ=UTC-8（POSIX 符号相反）；改 env 后重建容器；
2. 乱码：PYTHONUTF8=1 / PYTHONIOENCODING=utf-8 / LANG=C.UTF-8；显式 ascii 必须直接改成 utf-8；
3. 查看侧：终端切 UTF-8（chcp 65001 等）。

相关 canonical

按「前置 → 同根 / 同域 / 相关」读：

• 相关（报错相近，根因不同）：
• PowerShell 调 wsl 输出乱码（同为字符编码显示问题族）
• docker compose 起栈失败：依赖没就绪（容器运行配置同批实测 canonical）