解决Docker容器中.NET应用时区不一致问题

在Docker容器中运行.NET应用时，开发者经常会遇到时区显示不正确的问题。本文将以dotnet/dotnet-docker项目为例，深入分析这一现象的原因并提供解决方案。

问题现象

当在Docker容器中同时运行.NET和Go程序来显示当前时区时，即使挂载了主机的/etc/localtime文件，两个程序显示的时区信息也不一致。Go程序能正确识别主机时区，而.NET应用却显示为UTC时间。

根本原因

.NET运行时在Linux环境下获取时区信息的方式与Go语言不同。.NET主要依赖以下途径获取时区：

1. TZ环境变量
2. /etc/timezone文件内容
3. /etc/localtime符号链接指向的时区文件

在Docker容器中，如果没有显式设置TZ环境变量，.NET运行时可能无法正确继承主机的时区配置，导致默认使用UTC时区。

解决方案

方法一：设置TZ环境变量

最可靠的方式是通过环境变量显式指定时区：

docker run -e TZ=Asia/Shanghai -v $(pwd):/app -w /app mcr.microsoft.com/dotnet/sdk:9.0 dotnet run

这种方法确保.NET运行时能明确知道应该使用哪个时区。

方法二：挂载时区文件

虽然挂载/etc/localtime文件对某些应用有效，但对.NET应用来说，更推荐同时挂载/etc/timezone文件：

docker run -v /etc/timezone:/etc/timezone:ro -v /etc/localtime:/etc/localtime:ro -v $(pwd):/app -w /app mcr.microsoft.com/dotnet/sdk:9.0 dotnet run

方法三：在应用中硬编码时区

对于需要特定时区的应用，可以在代码中显式指定：

TimeZoneInfo tzi = TimeZoneInfo.FindSystemTimeZoneById("Asia/Shanghai");
DateTimeOffset now = TimeZoneInfo.ConvertTime(DateTimeOffset.UtcNow, tzi);
Console.WriteLine(now);

最佳实践

1. 在Dockerfile中明确设置TZ环境变量
2. 对于需要部署到不同时区环境的应用，使用环境变量配置时区
3. 在CI/CD流水线中确保测试环境与生产环境的时区设置一致
4. 对于关键时间操作，考虑始终使用UTC时间，仅在显示时转换为本地时间

总结

Docker容器中的时区问题源于容器化环境的隔离特性。通过理解.NET运行时获取时区的机制，开发者可以采取适当的配置方法确保时区一致性。设置TZ环境变量是最简单可靠的解决方案，也符合十二要素应用的原则。