Windows 10环境下Docker容器内C# .NET 5程序UTC时间异常如何解决？

问题根因 #

你遇到的UTC时间偏差、时区偏移异常问题由两个原因共同导致：

1. Windows 10宿主机运行Docker Desktop时的时间同步bug，尤其是使用WSL2后端的场景下，宿主机休眠、Docker长时间运行后，容器内部的系统时间会和宿主机脱钩，出现UTC时间直接等于宿主机本地时间的偏移问题。
2. 你使用的Ubuntu 20.04（focal）基础镜像默认没有安装时区数据包tzdata，仅传入TZ环境变量无法保证时区配置完全生效。

修复步骤 #

1. 修复Docker时间同步异常 #

• 临时修复：直接重启Docker Desktop，重启后所有容器的时间会自动和宿主机重新同步，偏差即可消失。
• 永久修复（WSL2后端适用）：打开WSL终端执行命令hwclock -s手动同步硬件时间，也可以在Windows计划任务中添加休眠唤醒后自动执行该命令的规则，避免后续休眠后再次出现偏移。
• 永久修复（Hyper-V后端适用）：管理员身份打开PowerShell执行Restart-Service DockerDesktopService重启Docker服务即可。

2. 补全镜像时区配置 #

修改Dockerfile，安装时区数据包tzdata，修改后的RUN指令如下：

RUN apt-get update && apt-get install -y libgdiplus python3 tzdata && rm -rf /var/lib/apt/lists/*

完成后重新构建镜像，再传入-e TZ=Europe/Stockholm参数运行，时区配置即可完全生效。

3. 补充注意事项 #

你的测试用例代码存在一处笔误：最后一行日志输出DateTimeOffset.Now时实际传入的是DateTime.Now，修正为如下代码即可保证日志输出准确：

Log.Information($"DateTimeOffset.Now: {DateTimeOffset.Now}");

内容的提问来源于stack exchange，提问作者MilleB