Apache Logging Log4j2 并发修改异常问题分析与修复

问题背景

在Apache Logging Log4j2日志框架的使用过程中，开发团队发现了一个在多线程环境下运行时修改日志级别时出现的并发修改异常(ConcurrentModificationException)。这个问题主要发生在服务启动阶段，当多个线程同时尝试通过Configurator.setLevel()方法动态调整日志级别时。

异常现象

异常堆栈显示，问题出现在LoggerContext.updateLoggers()方法中，具体是在处理日志记录器集合时发生的。从技术实现上看，这是由于Log4j2内部使用的WeakHashMap在并发遍历时被修改导致的经典并发问题。

技术分析

深入分析代码实现，我们发现问题的根源在于InternalLoggerRegistry类中的getLoggers()方法实现方式。该方法返回一个Stream对象，但在Stream被处理时，底层的WeakHashMap可能已经被其他线程修改。具体表现为：

1. 原始实现直接返回WeakHashMap值的Stream视图
2. 在多线程环境下，一个线程正在遍历Stream时，另一个线程可能修改了WeakHashMap
3. 这种修改会导致ConcurrentModificationException

解决方案

修复方案的核心思想是确保在获取日志记录器集合时创建一个不可变的快照。具体实现包括：

1. 在持有读锁的情况下，将所有Logger实例收集到一个List中
2. 然后基于这个List创建Stream返回
3. 这样即使原始WeakHashMap被修改，也不会影响已经创建的Stream

这种方案既保证了线程安全，又保持了Stream API的惰性求值特性。修复后的代码结构更加健壮，符合Java并发编程的最佳实践。

额外优化

在问题排查过程中，开发人员还发现LoggerRegistry类中存在一处可以改进的代码风格问题：

原始实现使用Stream.forEach()来填充外部集合，这种方式虽然功能正确，但不是最佳实践。更推荐的方式是使用collect(Collectors.toList())直接返回新的集合，这样代码更清晰且更符合函数式编程的风格。

影响范围

该问题影响Log4j2 2.x版本，特别是在高并发场景下动态调整日志级别的应用。修复后显著提高了框架在多线程环境下的稳定性。

总结

这个案例展示了在框架设计中处理并发问题的典型挑战。通过创建不可变的数据快照来避免并发修改异常，是Java并发编程中常用的解决方案。Log4j2团队对此问题的快速响应和修复，体现了该开源项目对稳定性和可靠性的高度重视。