在 Docker 容器中部署 Django 的时区问题

现在容器化部署已经非常成熟了，我们很多服务都会使用容器部署，更新恢复都非常方便，但是有一个问题比较麻烦，就是时区处理，通常情况下，都采用注入 TZ 环境变量来解决，但是实际这种处理方式在 django 中却是不行的。

Django 中与时区有关的配置

在Django的配置文件 settings.py 中，有两个配置参数是跟时间与时区有关的，分别是TIME_ZONE和USE_TZ。我们期望着通过在 settings.py 中配置以后，Django 就能正确地获取本地时间，但是实际上却事与愿违，我们看一看这两个设置有什么作用。

USE_TZ=True

如果 USE_TZ 设置为 True 时，Django 会使用系统默认设置的时区，此时的 TIME_ZONE 的设置基本是无效的，也就是无论有没有设置都不起作用。

USE_TZ=False

如果 USE_TZ 设置为 False

• TIME_ZONE 设置为 None
• Django 还是会使用默认的时区
• 若 TIME_ZONE 设置为其它时区的话

1. 如果是 Windows 系统，则 TIME_ZONE 设置是没用的，Django会使用本机的时间
2. 如果是其他系统，则会使用该时区的 UTC 时间

例如设置 USE_TZ = False, TIME_ZONE = ‘Asia/Shanghai’, 则使用上海的 UTC 时间。

到这一步，可能你会认为时间已经好了，但是实际上还没有，我们还需要关注系统时区的设置。

Linux 容器中时区的设置

现在我本地时间是：16:15，Django 中设置为：USE_TZ = False, TIME_ZONE = ‘Asia/Shanghai’

不注入 TZ=Asia/Shanghai 环境变量

进入容器查看容器时间和时区

系统时间显示的是 UTC 时区，时间为：08:15，刚好差 8 个小时

进入 Django 环境查看时间和时区

1. pythonmanage.pyshell
3. fromdatetimeimportdatetime
4. datetime.now()
5. #输出datetime.datetime(2021,10,8,8,24,8,289230)
7. fromdjango.utilsimporttimezone
8. timezone.get_current_timezone_name()
9. #输出'Asia/Shanghai'

注入环境变量 TZ=Asia/Shanghai

进入容器查看时间和时区

系统时间显示的是 Asia 时区，但是时间依然是 UTC 时间，并没有显示真正的本地时间

进入 Django 环境查看时间和时区

1. pythonmanage.pyshell
3. fromdatetimeimportdatetime
4. datetime.now()
5. #输出datetime.datetime(2021,10,8,8,24,8,289230)
7. fromdjango.utilsimporttimezone
8. timezone.get_current_timezone_name()
9. #输出'Asia/Shanghai'

可以看到，虽然时区变了，但是时间却还是 UTC 时间，无论是容器本身还是 Django 中

通过在网上查询，我们知道修改 Linux 系统时区要修改 /etc/localtime 文件

修改 Linux 容器时区

通常的做法是将宿主机的 /etc/localtime 文件拷贝到容器的 /etc/localtime 文件，但是我们通过查询发现 /etc/localtime 文件实际只是一个软连接，实际的文件是：/usr/share/zoneinfo/Asia/Shanghai

1. dockercp/usr/share/zoneinfo/Asia/Shanghaitest:/etc/localtime

在不给容器注入 TZ=Asia/Shanghai 环境变量的情况下，我们登录容器发现，容器的系统时间已经正确获取到本地时间和时区了

如果注入了 TZ=Asia/Shanghai 环境变量，即使把 /etc/localtime 文件替换了，也只是时区改变了，时间依然是 UTC 时间

进入 Django 环境查看时间

1. pythonmanage.pyshell
3. fromdatetimeimportdatetime
4. datetime.now()
5. #输出datetime.datetime(2021,10,8,8,43,43,754698)

Linux 系统时间已经正常了，但是 Django 环境中的时间还是不正确，依然是 UTC 时间，这时候很多人就有点抓狂了，可能觉得是 settings.py 中的 USE_TZ 和 TIME_ZONE 设置有问题，其实问题并不在这里。原因是因为 datetime 库会去 /usr/share/zoneinfo/ 目录下寻找 Asia/Shanghai 这个文件，而我们的镜像中不包含这个目录，所以 Django 还是使用了 UTC 时区。解决的办法非常简单：创建 /usr/share/zoneinfo/Asia 目录，拷贝文件到这个目录下就行了

1. #在容器内（如不不存在这个目录）
2. mkdir-p/usr/share/zoneinfo/Asia
4. #在容器外
5. dockercp/usr/share/zoneinfo/Asia/Shanghaitest:/usr/share/zoneinfo/Asia/Shanghai

然后登录到容器内，进入 Django 环境下查看时间

1. pythonmanage.pyshell
3. fromdatetimeimportdatetime
4. datetime.now()
5. #输出datetime.datetime(2021,10,8,16,49,32,57)

这下时间就完全正确了。

总结

对于容器时区的问题，建议在容器制作阶段，安装并设置好 /etc/localtime，例如在 dockerfile 中添加如下语句

1. ADD/usr/share/zoneinfo/Asia/Shanghai/usr/share/zoneinfo/Asia/Shanghai
3. RUNln-s/usr/share/zoneinfo/Asia/Shanghai/etc/localtime

这样我们的容器在启动时就无需关注时区问题了，如果容器已经制作好了，在启动的时候挂载一下时区文件

1. dockerrun-d-v/etc/localtime:/etc/localtime-v/usr/share/zoneinfo/Asia/Shanghai:/usr/share/zoneinfo/Asia/ShanghaiimageName

这种方式就比较麻烦。还有一种情况就是我们现在碰到的，服务已经上线了，发现时间有问题，就手动拷贝一下那两个文件到容器中，然后重启一下容器

1. dockercp/usr/share/zoneinfo/Asia/Shanghaitest:/etc/localtime
2. dockercp/usr/share/zoneinfo/Asia/Shanghaitest:/usr/share/zoneinfo/Asia/Shanghai
3. dockerrestarttest

原文链接：https://www.toutiao.com/a7009592146798051851/