处理Docker容器化部署Tomcat服务碰到的时区问题

用Docker工具容器化部署服务以后，碰到的问题比较多。
其中比较特出的问题是这个时区问题。

1 问题现象：

举个例子，有个小功能，须要记录计划开始时间。
前台输入的时间是：2018.4.24 00:00:00。
后台记录的计划开始时间倒是：2018.4.23 16:00:00。
能够看出，整整提早了8个小时。

2 问题处理过程：

多笔数据都是刚恰好差别8个小时，那通常都是时区问题了。
加上我是用docker容器化部署的，因此，我开始估计是Docker的时区没弄正确致使的问题。

验证问题：
Docker宿主查看时间：

[apiuser@xygerp-api software]$ date
2018年 04月 24日 星期二 15:00:05 CST

说明宿主的时区是木有问题的。

UTC是世界时区，CST是东八区时间
CST应该是指（China Shanghai Time，东八区时间）
UTC应该是指（Coordinated Universal Time，标准时间）

接着，exec进入容器，查看容器的时间有没有问题：

备注：为方便测试，我新建了一个docker容器（timezone-test）。

sudo docker run --name timezone-test -p 8800:8080 -v /etc/localtime:/etc/localtime chaimm/tomcat:1.1

进入容器，查看容器的时间：

[apiuser@xygerp-api software]$ sudo docker exec -it timezone-test /bin/sh
sh-4.2$ date
Tue Apr 24 15:05:14 CST 2018

能够看出，时区是没问题的，可是为何运行在该容器的Tomcat服务的时区（不管是操做DB的时间，仍是Tomcat的Log的时间）都是UTC？
例以下面的日志，log时间是：24-Apr-2018 07:03:55.381
应该是：24-Apr-2018 15:03:55.381才对。

24-Apr-2018 07:03:55.381 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory /opt/tomcat/webapps/host-manager
24-Apr-2018 07:03:55.410 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory /opt/tomcat/webapps/host-manager has finished in 29 ms
24-Apr-2018 07:03:55.410 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory /opt/tomcat/webapps/manager
24-Apr-2018 07:03:55.431 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory /opt/tomcat/webapps/manager has finished in 21 ms
24-Apr-2018 07:03:55.437 INFO [main] org.apache.coyote.AbstractProtocol.start Starting ProtocolHandler [http-nio-8080]
24-Apr-2018 07:03:55.447 INFO [main] org.apache.coyote.AbstractProtocol.start Starting ProtocolHandler [ajp-nio-8009]
24-Apr-2018 07:03:55.450 INFO [main] org.apache.catalina.startup.Catalina.start Server startup in 886 ms

这个问题困扰了我蛮久，最后通过找一些资料，发现原来是Tomcat启动的时候，时区实际是java启动的默认时区。
这样子，实际上不少时区：

时区功能	时区说明
Java	JVM启动时候的时区。若是不指定，则默认取系统时区，就是：System.getProperty("user.timezone")
MySQL	数据库有时区，直接用：select now()能够查看确认。可是，Java的JDBC直接新增的数据是不会参考Mysql自己的时区。举个例子：INSERT什么时间就是什么时间！
Docker宿主	其实是操做系统OS的时区。若是安装系统的时候选择中国上海时区，那通常是CST（中国时区）。
Docker容器	容器自己也是一个操做系统(虚拟系统)。当容器时区和宿主时区不一致，能够修改。若是有疑问能够直接exec到容器里面查看容器时区。
Tomcat服务	Tomcat是运行Java的Web应用服务器，因此，它的时区实际上就是JVM的时区。

从上面的表格能够看出，实际上，在Java中处理的时区，说到底仍是以JVM启动的时候的时区为主！
只不过，大部分状况下，JVM启动若是没指定时区，那默认=操做系统的时区。
问题来了，如何确认JVM默认启动的时区是哪一个？
这里有个小办法：

sh-4.2$ vi TestTimezone.java
public class TestTimezone{
   public static void main(String[] args){
      System.out.println(new java.util.Date());
      System.out.println(System.getProperty("user.timezone"));
   }
}

而后再编译而且运行它，看结果就知道JVM默认启动的时区是哪一个了：

sh-4.2$ javac TestTimezone.java
sh-4.2$ java TestTimezone
Tue Apr 24 07:27:30 UTC 2018
UTC

从上面能够看出，就算我在Docker容器里面的系统时间已是CST时区，可是，System.getProperty("user.timezone")是UTC，致使Java启动的时候，以UTC时区启动。
因此就出现了我碰到的问题！
这个才是根本缘由。

备注： 一样的办法，在宿主执行，发现宿主就能抓取正确的时区。

[apiuser@xygerp-api software]$ java TestTimezone
Tue Apr 24 15:31:03 CST 2018
Asia/Shanghai

3 问题解决方案

既然发现了问题，是在Docker容器环境下，System.getProperty("user.timezone")抓的值不是CST时区致使的问题。那其中一个简单的解决办法是，在Tomcat启动的 时候，指定时区便可。
具体办法：

[apiuser@xygerp-api software]$ sudo docker exec -it timezone-test /bin/sh
sh-4.2$ ls
LICENSE        TestTimezone.class        bin   scripts
NOTICE           TestTimezone.java        conf  temp
RELEASE-NOTES  apache-tomcat-7.0.82        lib   webapps
RUNNING.txt    apache-tomcat-7.0.82.tar.gz  logs  work
sh-4.2$ cd bin/
sh-4.2$ vi catalina.sh
修改这里：
JAVA_OPTS="$JAVA_OPTS -Djava.protocol.handler.pkgs=org.apache.catalina.webresources -Duser.timezone=GMT+08"

保存您的修改，再重启启动docker：

[apiuser@xygerp-api software]$ sudo docker restart timezone-test
timezone-test
[apiuser@xygerp-api software]$

再查看timezone-test容器的log：

[apiuser@xygerp-api ~]$ sudo docker logs -f --tail 1000 timezone-test
24-Apr-2018 15:41:27.436 INFO [main] org.apache.catalina.core.AprLifecycleListener.lifecycleEvent The APR based Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path: /usr/java/packages/lib/amd64:/usr/lib64:/lib64:/lib:/usr/lib
24-Apr-2018 15:41:27.629 INFO [main] org.apache.coyote.AbstractProtocol.init Initializing ProtocolHandler ["http-nio-8080"]
24-Apr-2018 15:41:27.647 INFO [main] org.apache.tomcat.util.net.NioSelectorPool.getSharedSelector Using a shared selector for servlet write/read
24-Apr-2018 15:41:27.650 INFO [main] org.apache.coyote.AbstractProtocol.init Initializing ProtocolHandler ["ajp-nio-8009"]
24-Apr-2018 15:41:27.652 INFO [main] org.apache.tomcat.util.net.NioSelectorPool.getSharedSelector Using a shared selector for servlet write/read
24-Apr-2018 15:41:27.652 INFO [main] org.apache.catalina.startup.Catalina.load Initialization processed in 809 ms
24-Apr-2018 15:41:27.683 INFO [main] org.apache.catalina.core.StandardService.startInternal Starting service Catalina
24-Apr-2018 15:41:27.683 INFO [main] org.apache.catalina.core.StandardEngine.startInternal Starting Servlet Engine: Apache Tomcat/8.5.9
24-Apr-2018 15:41:27.697 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory /opt/tomcat/webapps/ROOT
24-Apr-2018 15:41:28.153 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory /opt/tomcat/webapps/ROOT has finished in 456 ms
24-Apr-2018 15:41:28.154 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory /opt/tomcat/webapps/docs
24-Apr-2018 15:41:28.179 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory /opt/tomcat/webapps/docs has finished in 25 ms
24-Apr-2018 15:41:28.179 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory /opt/tomcat/webapps/examples
24-Apr-2018 15:41:28.492 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory /opt/tomcat/webapps/examples has finished in 312 ms
24-Apr-2018 15:41:28.492 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory /opt/tomcat/webapps/host-manager
24-Apr-2018 15:41:28.524 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory /opt/tomcat/webapps/host-manager has finished in 32 ms
24-Apr-2018 15:41:28.525 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory /opt/tomcat/webapps/manager
24-Apr-2018 15:41:28.548 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory /opt/tomcat/webapps/manager has finished in 23 ms
24-Apr-2018 15:41:28.555 INFO [main] org.apache.coyote.AbstractProtocol.start Starting ProtocolHandler [http-nio-8080]
24-Apr-2018 15:41:28.565 INFO [main] org.apache.coyote.AbstractProtocol.start Starting ProtocolHandler [ajp-nio-8009]
24-Apr-2018 15:41:28.567 INFO [main] org.apache.catalina.startup.Catalina.start Server startup in 914 ms

能够看到，里面的日志的时间已经正确啦！

备注：上面的只是其中一个解决办法，也能够经过调整Docker容器的System.getProperty("user.timezone")的值，来让JVM在启动的时候能正确找时区！
仍是那句话：出现问题的话，必需要找到问题出错的地方，才好解决问题啊！我就是绕了许多的弯路才找到问题的缘由。一开始一直觉得是Docker容器虚拟机的时区问题，因此困扰了好久！

更新：
另一个作法，也能够解决这个问题：
其实就是启动容器的时候，指定时区便可。

sudo docker run --name timezone-test2 -p 8800:8080 -e TZ="Asia/Shanghai" -v /etc/localtime:/etc/localtime chaimm/tomcat:1.1

参考连接：
https://segmentfault.com/a/11...
https://www.jianshu.com/p/5b1...