在分布式系统的开发实践中，经常会遇到一个让人头疼的细节：集群中不同节点显示的时间数据不一致。

排查后才发现，问题根源在于各节点的系统时区设置不同，导致 SimpleDateFormat 类解析相同的时间戳时给出了不同的结果。

这里把踩坑过程记录下来，供大家参考。

Ja va中的 SimpleDateFormat 类

SimpleDateFormat 负责将 Date 对象转换成指定格式的字符串。

但要注意，对于同一个 Date 对象，如果所在环境的时区不同，SimpleDateFormat 解析出的字符串也会不同。

这一点很容易被忽略。

示例代码

下面是一个简单的示例：

import ja va.text.SimpleDateFormat;
public class Main {
    public static void main(String[] args) {
        long mm = 1522480737272l;
        SimpleDateFormat s = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        System.out.println(s.format(mm));
    }
}

在实验环境中，这段代码的输出结果是：2018-03-31 15:18:57，如下图所示：

调整计算机的系统时区

如果改变系统时区，同样的代码会输出不同的结果。

这说明 SimpleDateFormat 在未显式指定时区时，会依赖当前系统时区。

以上实验表明

对于同一个表示当前时间毫秒数的 long 值，在不显式指定时区的情况下，SimpleDateFormat 会参考当前系统的时区设置。

系统时区一变，解析结果也会跟着变化。

进一步实验还发现，当 SimpleDateFormat 解析传入的毫秒参数时，它默认认为这个毫秒数代表的是 UTC 标准时间，然后再结合本机系统时区进行时差调整。

极端示例

举个极端的例子：当传入值为 0，且系统时区设置为 UTC 时，输出结果就是 1970-01-01 00:00:00。

修改上面的代码验证一下：

import ja va.text.SimpleDateFormat;
public class Main {
    public static void main(String[] args) {
        // long mm = 1522480737272l;
        SimpleDateFormat s = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        System.out.println(s.format(0));
    }
}

设置本机系统时区为UTC

执行上述代码，结果如下：

如果显式地指定 SimpleDateFormat 对象的时区

在这种情况下，解析过程会严格按照指定的时区进行。

下面的代码清晰地展示了：即使传入相同的毫秒参数，只要时区设置不同，输出结果就截然不同。

import ja va.text.SimpleDateFormat;
import ja va.util.TimeZone;
public class Main {
    public static void main(String[] args) {
        long mm = 1522480737272l;
        SimpleDateFormat s = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        s.setTimeZone(TimeZone.getTimeZone("UTC"));
        System.out.println("UTC: " + s.format(mm));
        s.setTimeZone(TimeZone.getTimeZone("CNT"));
        System.out.println("CNT: " + s.format(mm));
        s.setTimeZone(TimeZone.getTimeZone("BET"));
        System.out.println("BET: " + s.format(mm));
        s.setTimeZone(TimeZone.getTimeZone("ECT"));
        System.out.println("UECT: " + s.format(mm));
    }
}

程序输出结果如下：

总结

• 时区问题在分布式系统中极易引发“隐身”的 bug。
• 当集群各节点时间显示不一致时，优先检查系统时区是否统一。
• 如果代码中需要跨时区处理时间，务必显式设置 SimpleDateFormat 的时区。
• 避免依赖系统默认设置。

希望这个踩坑记录能帮助大家少走弯路。

《夸克》非常好用的免费AI浏览器

下载APP查看