SimpleDateFormat在多线程下的安全问题及解决

更新时间：2026年03月07日 14:58:59 作者：zmbwcx2003

SimpleDateFormat类在Java中用于日期时间的格式化和解析,但在高并发环境下存在线程不安全的问题,原因是它共享了一个Calendar对象,导致多个线程操作时出现冲突,为了解决这个问题,可以使用局部变量、加锁或使用线程安全的DateTimeFormatter类

情景重现

SimpleDateFormat类是Java开发中的一个日期时间的转化类。它可以满足绝大多数的开发场景，但是在高并发下会出现并发问题。

接下来查看下文中的案例。

public class TestSimpleDateFormat {
    public static void main(String[] args) {
        SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
        for (int i = 0; i < 5; i++) {
            new Thread(()->{
                try {
                    Date parse = format.parse("2003-01-01");
                    System.out.println(parse);
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }).start();
        }
    }
}

上面代码简单来说就是创建了一个SimpleDateFormat类对象，该对象被后续会被五个线程使用，去转化日期格式并打印。

我们来查看输出结果：

java.lang.NumberFormatException: empty String
   at sun.misc.FloatingDecimal.readJavaFormatString(FloatingDecimal.java:1842)
   at sun.misc.FloatingDecimal.parseDouble(FloatingDecimal.java:110)
   at java.lang.Double.parseDouble(Double.java:538)
   at java.text.DigitList.getDouble(DigitList.java:169)
   at java.text.DecimalFormat.parse(DecimalFormat.java:2056)
   at java.text.SimpleDateFormat.subParse(SimpleDateFormat.java:1869)
   at java.text.SimpleDateFormat.parse(SimpleDateFormat.java:1514)
   at java.text.DateFormat.parse(DateFormat.java:364)
   at test.lambda$main$0(test.java:21)
   at java.lang.Thread.run(Thread.java:745)
java.lang.NumberFormatException: multiple points
   at sun.misc.FloatingDecimal.readJavaFormatString(FloatingDecimal.java:1890)
   at sun.misc.FloatingDecimal.parseDouble(FloatingDecimal.java:110)
   at java.lang.Double.parseDouble(Double.java:538)
   at java.text.DigitList.getDouble(DigitList.java:169)
   at java.text.DecimalFormat.parse(DecimalFormat.java:2056)
   at java.text.SimpleDateFormat.subParse(SimpleDateFormat.java:1869)
   at java.text.SimpleDateFormat.parse(SimpleDateFormat.java:1514)
   at java.text.DateFormat.parse(DateFormat.java:364)
   at test.lambda$main$0(test.java:21)
   at java.lang.Thread.run(Thread.java:745)
java.lang.NumberFormatException: multiple points
   at sun.misc.FloatingDecimal.readJavaFormatString(FloatingDecimal.java:1890)
   at sun.misc.FloatingDecimal.parseDouble(FloatingDecimal.java:110)
   at java.lang.Double.parseDouble(Double.java:538)
   at java.text.DigitList.getDouble(DigitList.java:169)
   at java.text.DecimalFormat.parse(DecimalFormat.java:2056)
   at java.text.SimpleDateFormat.subParse(SimpleDateFormat.java:1869)
   at java.text.SimpleDateFormat.parse(SimpleDateFormat.java:1514)
   at java.text.DateFormat.parse(DateFormat.java:364)
   at test.lambda$main$0(test.java:21)
   at java.lang.Thread.run(Thread.java:745)
java.lang.NumberFormatException: empty String
   at sun.misc.FloatingDecimal.readJavaFormatString(FloatingDecimal.java:1842)
   at sun.misc.FloatingDecimal.parseDouble(FloatingDecimal.java:110)
   at java.lang.Double.parseDouble(Double.java:538)
   at java.text.DigitList.getDouble(DigitList.java:169)
   at java.text.DecimalFormat.parse(DecimalFormat.java:2056)
   at java.text.SimpleDateFormat.subParse(SimpleDateFormat.java:1869)
   at java.text.SimpleDateFormat.parse(SimpleDateFormat.java:1514)
   at java.text.DateFormat.parse(DateFormat.java:364)
   at test.lambda$main$0(test.java:21)
   at java.lang.Thread.run(Thread.java:745)
Fri Nov 01 00:00:00 CST 2222

可以看到，只输出了一次时间转化，并且该输出格式还是错误的。

接下来我们来查看为什么SimpleDateFormat类是线程不安全的。

SimpleDateFormat解析

我们根据parse()方法，查看SimpleDateFormat是如何进行格式转换的。

我们可以看到，返回结果是根据另一个方法获取到的，接下来我们接着查看该parse()源码。

这是一个抽象方法，接着我们去查看它的具体实现。

可以看到该方法很长，但是我们只关注返回如何结果，直接拉到最后查看该方法如何返回一个日期格式。上图中，最后一次修改parseDate对象是在箭头的位置。那么我们查看getTime()方法。

可以看到该方法是由Calendar类提供的，该类名翻译为中文就是日历的意思，并且返回结果也是我们需要的日期格式，那么我们就可以确定该方法用于给parseDate对象提供返回值的，接下来回退一下查看其他方法哪个是提供Calendar对象来调用getTime()方法的。

现在我们清楚了Calendar类对象是由establish()方法提供的了，该方法中需要一个参数calendar对象。该对象由SimpleDateFormat的父类DateFormat来维护。

此时我们或许大概明白是因为SimpleDateFormat类之所以线程不安全的问题是因为在多线程下共享了calendar对象。接下来我们继续查看establish()方法，验证是否是这样，下面是具体源码

    Calendar establish(Calendar cal) {
        boolean weekDate = isSet(WEEK_YEAR)
                       && field[WEEK_YEAR] > field[YEAR];
        if (weekDate && !cal.isWeekDateSupported()) {
            // Use YEAR instead
            if (!isSet(YEAR)) {
                set(YEAR, field[MAX_FIELD + WEEK_YEAR]);
            }
            weekDate = false;
        }

        cal.clear();
        // Set the fields from the min stamp to the max stamp so that
        // the field resolution works in the Calendar.
        for (int stamp = MINIMUM_USER_STAMP; stamp < nextStamp; stamp++) {
            for (int index = 0; index <= maxFieldIndex; index++) {
                if (field[index] == stamp) {
                    cal.set(index, field[MAX_FIELD + index]);
                    break;
                }
            }
        }

        if (weekDate) {
            int weekOfYear = isSet(WEEK_OF_YEAR) ? field[MAX_FIELD + WEEK_OF_YEAR] : 1;
            int dayOfWeek = isSet(DAY_OF_WEEK) ?
                                field[MAX_FIELD + DAY_OF_WEEK] : cal.getFirstDayOfWeek();
            if (!isValidDayOfWeek(dayOfWeek) && cal.isLenient()) {
                if (dayOfWeek >= 8) {
                    dayOfWeek--;
                    weekOfYear += dayOfWeek / 7;
                    dayOfWeek = (dayOfWeek % 7) + 1;
                } else {
                    while (dayOfWeek <= 0) {
                        dayOfWeek += 7;
                        weekOfYear--;
                    }
                }
                dayOfWeek = toCalendarDayOfWeek(dayOfWeek);
            }
            cal.setWeekDate(field[MAX_FIELD + WEEK_YEAR], weekOfYear, dayOfWeek);
        }
        return cal;
    }

可以看到，在该方法中，对cal对象执行了clear()方法与set()方法，我们查看clear方法是做什么的

该方法提供了类似初始化的功能，将上一次的格式转化保存的cal属性清除。

而set()方法将本次的格式转换需要的数据更新。因此，我们可以确定了SimpleDateFormat类之所以线程不安全就是因为共享了calendar对象。

解决方案

为了避免SimpleDateFormat格式转换带来的并发问题，我们可以采取以下几个措施

局部变量

我们已经知道了产生线程安全问题的原因是共享了相同属性，那么我们只要让每个线程都包含自己的属性就可以避免该问题的发生。

具体实现代码如下：

public class TestSimpleDateFormat {
    public static void main(String[] args) {
        for (int i = 0; i < 5; i++) {
        new Thread(()->{
            try {
                    SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
                    Date parse = format.parse("2003-01-01");
                    System.out.println(parse);
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }).start();
        }
    }
}

运行结果如下：

Wed Jan 01 00:00:00 CST 2003
Wed Jan 01 00:00:00 CST 2003
Wed Jan 01 00:00:00 CST 2003
Wed Jan 01 00:00:00 CST 2003
Wed Jan 01 00:00:00 CST 2003

这种方式不太推荐，因为会创建大量的SimpleDateFormat对象，占用内存空间。

加锁

除了让每个线程都拥有自己独立的对象外，我们也可以保证在同一时刻下，只有一个线程对共享属性进行修改，那就是加锁。具体实现代码如下

public class TestSimpleDateFormat{
    public static void main(String[] args) {
        SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
        for (int i = 0; i < 5; i++) {
            new Thread(() -> {
                try {
                    Date parse;
                    synchronized (format){
                        parse = format.parse("2003-01-01");
                    }
                    System.out.println(parse);
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }).start();
        }
    }
}

但是这种方法不太推荐，因为能够出现格式转化错误的情况已经是很大的并发了，如果还使用同步锁的话会影响性能。

使用线程变量

public class test {
    private static ThreadLocal<DateFormat> threadLocal = new ThreadLocal<DateFormat>() {
        @Override
        protected DateFormat initialValue() {
            return new SimpleDateFormat("yyyy-MM-dd");
        }
    };

    public static void main(String[] args) {
        for (int i = 0; i < 5; i++) {
            new Thread(() -> {
                try {
                    Date parse = threadLocal.get().parse("2023-01-01");
                    System.out.println(parse);
                } catch (ParseException e) {
                    e.printStackTrace();
                }
            }).start();
        }
    }
}

使用DateTimeFormatter

在JDK8之后提供了线程安全的格式转化DateTimeFormatter类，使用方法如下

public class test {
    public static void main(String[] args) {
        DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
        for (int i = 0; i < 5; i++) {
            new Thread(() -> {
                try {
                    TemporalAccessor parse = dateTimeFormatter.parse("2003-06-03");
                        System.out.println(parse);
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }).start();
        }
    }
}

输出结果为：

{},ISO resolved to 2003-06-03
{},ISO resolved to 2003-06-03
{},ISO resolved to 2003-06-03
{},ISO resolved to 2003-06-03
{},ISO resolved to 2003-06-03

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

java中判断字符串数组是否包含特定字符串的三种方法实现与对比
这篇文章主要为大家详细介绍了java中判断字符串数组是否包含特定字符串的三种方法实现与对比,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下
2025-12-12
Java 导出Excel增加下拉框选项
这篇文章主要介绍了Java 导出Excel增加下拉框选项，excel对于下拉框较多选项的，需要使用隐藏工作簿来解决，使用函数取值来做选项，下文具体的操作详情，需要的小伙伴可以参考一下
2022-04-04
spring boot使用thymeleaf为模板的基本步骤介绍
Spring Boot项目的默认模板引擎是Thymeleaf，这没什么好说的，个人觉得也非常好，下面这篇文章主要给大家介绍了关于spring boot使用thymeleaf为模板的相关资料，需要的朋友可以参考借鉴，下面来一起学习学习吧。
2018-01-01
Java Socket聊天室编程(二)之利用socket实现单聊聊天室
这篇文章主要介绍了Java Socket聊天室编程(二)之利用socket实现单聊聊天室的相关资料,非常不错，具有参考借鉴价值，需要的朋友可以参考下
2016-09-09
使用Jmeter进行http接口测试的详细流程
本文主要针对http接口进行测试,使用Jmeter工具实现,　　Jmter工具设计之初是用于做性能测试的,它在实现对各种接口的调用方面已经做的比较成熟,因此,本次直接使用Jmeter工具来完成对Http接口的测试,需要的朋友可以参考下
2024-12-12
SpringBoot中自动配置原理解析
SpringBoost是基于Spring框架开发出来的功能更强大的Java程序开发框架,本文将以广角视觉来剖析SpringBoot自动配置的原理，涉及部分Spring、SpringBoot源码，需要的可以参考下
2023-11-11
java中ThreadLocal和ThreadLocalMap浅析
这篇文章主要介绍了java中ThreadLocal和ThreadLocalMap浅析,ThreadLocal类用来设置线程私有变量本身不储存值主要提供自身引用和操作ThreadLocalMap 属性值得方法,需要的朋友可以参考下
2023-09-09
Springboot转发重定向实现方式解析
这篇文章主要介绍了springboot转发重定向实现方式解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-03-03
Java经典面试题汇总:网络编程
本篇总结的是Java 网络编程相关的面试题，后续会持续更新，希望我的分享可以帮助到正在备战面试的实习生或者已经工作的同行，如果发现错误还望大家多多包涵，不吝赐教，谢谢
2021-07-07
解读java.lang.Character.isLetterOrDigit()的使用方式
这篇文章主要介绍了解读java.lang.Character.isLetterOrDigit()的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-06-06