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

问题背景

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

异常现象

异常堆栈显示，问题发生在LoggerContext.updateLoggers()方法中，具体是在处理日志记录器集合时发生的并发修改。异常表明在对HashMap进行迭代操作时，集合被其他线程修改，导致迭代器检测到并发修改而抛出异常。

技术分析

深入分析问题根源，我们发现这与Log4j2内部的两个关键类有关：

1. LoggerRegistry类：负责管理日志记录器的注册表
2. InternalLoggerRegistry类：内部日志记录器注册表的实现

问题主要出在InternalLoggerRegistry.getLoggers()方法的实现上。该方法返回一个Stream对象，但在获取Stream后立即释放了读锁。这意味着虽然获取Stream时持有锁，但实际使用Stream时锁已被释放，导致在多线程环境下可能出现并发修改。

解决方案

修复方案主要包含两个部分：

1. InternalLoggerRegistry类的修复：

   • 在保持读锁的情况下，先将所有日志记录器收集到一个List中
   • 然后释放锁并返回该List的Stream
   • 这样确保了在遍历日志记录器时数据的一致性

2. LoggerRegistry类的改进：

   • 重构了getLoggers()方法的实现
   • 避免了在Stream.forEach()中直接修改集合的不良实践
   • 改为使用collect(Collectors.toList())方式收集结果

修复效果

这个修复方案：

• 解决了在多线程环境下动态修改日志级别时的并发问题
• 保持了API的兼容性
• 提高了代码的健壮性和线程安全性
• 遵循了更好的Stream API使用实践

最佳实践建议

基于这个问题的经验，我们建议开发者在以下场景中注意：

1. 当在多线程环境中使用Log4j2时，特别是动态修改配置时
2. 在使用Stream API处理可能被并发修改的集合时
3. 设计需要返回Stream的API时，考虑数据一致性和线程安全问题

这个修复已经包含在Log4j2的后续版本中，建议用户升级到包含此修复的版本以获得更好的稳定性和线程安全性。