Log4j2 2.19.0重新配置偶发卡顿问题排查求助

问题本质 #

你遇到的偶发死循环卡顿，核心原因是Log4j2 2.19.0版本中AwaitCompletionReliabilityStrategy的并发缺陷，同时也可以通过优化配置流程降低触发概率。

具体原因说明 #

AwaitCompletionReliabilityStrategy的设计逻辑是：在切换配置时，等待所有正在处理的日志事件完成（通过counter计数，beforeLogEvent递增、afterLogEvent递减），确保配置切换不丢失日志。但在高并发场景下，存在极端情况：某个日志事件的beforeLogEvent成功递增counter，但afterLogEvent因线程中断、异步日志组件异常等原因未执行递减操作，导致counter始终卡在1，触发无限等待的死循环。这个问题属于特定版本的并发Bug，在2.20.0及以上版本已被官方修复。

配置步骤是否遗漏？ #

你当前使用的代码是官方推荐的基础配置切换方式，没有明显遗漏，但可以补充优化步骤：

• 确认LogManager.getContext(false)的false参数正确：该参数表示获取当前应用的Logger上下文，而非创建新上下文，这是正确的用法。
• 若应用使用了异步日志组件（如AsyncAppender），切换配置前可尝试在业务低峰期操作，减少并发冲突。

解决/规避方案 #

1. 优先升级Log4j2版本 #

直接升级到2.20.0及以上版本，官方已修复该并发场景下的计数错误问题，这是最彻底的解决方式。

2. 更换可靠性策略（无法升级时） #

在log4j2.xml的根节点Configuration中指定其他可靠性策略，绕过AwaitCompletion的缺陷：

<!-- 使用Default策略，等待未完成事件但逻辑更简单 -->
<Configuration reliabilityStrategy="default">
<!-- 或者使用FireAndForget策略，不等待未完成事件，可能丢失少量日志但无死循环风险 -->
<!-- <Configuration reliabilityStrategy="fireAndForget"> -->
    <!-- 你的其他配置内容 -->
</Configuration>

3. 添加超时机制 #

通过系统属性配置等待超时，超时后强制终止等待，避免死循环（2.19.0版本支持该属性）：

# JVM启动参数中添加
-Dlog4j2.configurationReloadTimeout=5000

该参数设置超时时间为5000毫秒（可根据业务调整），超时后即使counter未归零，配置切换也会继续执行。

4. 优化切换时机 #

尽量在业务低峰期触发配置重新加载，减少高并发下日志事件与配置切换的冲突概率。

内容的提问来源于stack exchange，提问作者contivero