Java SimpleDateFormat 多线程下日期错乱怎么办？

Question

仓乃文 · Accepted Answer

SimpleDateFormat 内部共用一个 Calendar 对象，多线程并发调用 format() 或 parse() 时，Calendar 的状态被互相覆盖，导致日期错乱、解析出错误日期甚至 ArrayIndexOutOfBoundsException。这个问题极隐蔽，测试环境单线程正常，上线后高并发才暴露。

错误写法：
```java
private static final SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
// 多线程并发调用
String date = sdf.format(new Date()); // 可能输出别人的日期
```

修复方法 1——DateTimeFormatter（Java 8+，推荐）：
```java
private static final DateTimeFormatter formatter =
    DateTimeFormatter.ofPattern("yyyy-MM-dd");
// DateTimeFormatter 是不可变对象，天然线程安全
String date = LocalDate.now().format(formatter);
```

修复方法 2——ThreadLocal：
```java
private static final ThreadLocal<SimpleDateFormat> sdf =
    ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy-MM-dd"));

String date = sdf.get().format(new Date());
```

修复方法 3——每次 new（性能差，不推荐）：
```java
String date = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
```

补充说明：
- DateTimeFormatter 是 Java 8 引入的，不可变且线程安全，是最佳方案
- 所有 java.text.Format 的子类（NumberFormat、DateFormat、MessageFormat）都不是线程安全的
- 这个 bug 的隐蔽性在于：不是每次都错，而是偶尔错，极难复现
- 规则：日期格式化一律用 DateTimeFormatter，彻底告别 SimpleDateFormat