Log4j2 JSON模板布局中pointMatcherStrings引发的异常问题解析

问题背景

在使用Log4j2的JSON模板布局功能时，开发者尝试通过配置pointMatcherStrings参数来过滤Java内部堆栈信息，仅保留应用自身的错误堆栈。但在实际使用过程中，却意外捕获到了Log4j2自身的异常信息，这显然不符合预期行为。

技术细节分析

核心配置解析

问题中涉及的JSON模板配置关键部分如下：

{
  "$resolver": "exception",
  "field": "stackTrace",
  "stackTrace": {
    "stringified": {
      "truncation": {
        "suffix": "... [truncated]",
        "pointMatcherStrings": ["java.base"]
      }
    }
  }
}

这段配置的本意是通过pointMatcherStrings参数过滤掉java.base包路径下的堆栈信息，实现堆栈信息的精简输出。

异常现象

开发者观察到控制台输出了非预期的Log4j2内部错误：

ArrayIndexOutOfBoundsException: Index 1500 out of bounds for length 1500
    at org.apache.logging.log4j.layout.template.json.util.TruncatingBufferedWriter.charAt(...)

这表明堆栈截断处理过程中出现了数组越界问题。

问题排查与验证

环境复现尝试

技术专家尝试在以下环境中复现问题：

• Spring Boot 3.3.3
• Log4j2 2.23.1
• JDK 17

通过构建测试用例，包括：

1. 配置排除默认日志框架
2. 显式引入log4j2依赖
3. 创建触发NPE的测试组件
4. 应用相同的JSON模板配置

验证结果

在标准测试环境下，该配置工作正常：

• 成功过滤了java.base相关的堆栈信息
• 未出现Log4j2自身的异常输出
• 输出格式符合JSON规范

可能原因推测

虽然问题未能稳定复现，但结合异常信息分析，可能的原因包括：

1. 缓冲区大小限制：旧版本可能存在固定大小的缓冲区，当处理特定长度的堆栈时可能越界
2. 并发问题：在多线程环境下，缓冲区可能被异常共享
3. 版本差异：2.19.1与2.23.1之间可能存在相关修复

解决方案建议

1. 版本升级：建议升级至Log4j2 2.23.1或更高版本
2. 配置检查：确保没有其他配置干扰JSON输出
3. 异常处理：考虑添加全局异常处理器捕获日志框架自身的异常

最佳实践

对于需要过滤堆栈信息的场景，推荐：

1. 使用最新稳定版Log4j2
2. 在开发环境充分测试配置
3. 考虑结合filters进行更精细的日志控制
4. 对于生产环境，建议进行灰度发布验证配置变更

总结

Log4j2的JSON模板布局功能提供了强大的日志格式化能力，但在使用高级特性时需要特别注意版本兼容性和配置细节。通过规范的配置管理和版本控制，可以充分发挥其优势，避免类似问题的发生。