Spring下Log4j2.json配置日志同时输出控制台与文件报错无写入

安全阿岳

2026-11-1

问题核心成因

这个问题的触发逻辑和你看到的报错栈完全对应，核心原因有3层：

直接触发报错的原因：Log4j2要求所有非root的Logger必须显式配置唯一的name属性（通常为指定监听的业务包全路径），你在loggers节点下配置单独的业务logger时，漏写/错写了该属性，导致Log4j2初始化Logger时拿到null参数，直接抛出Loggers cannot be configured without a name: arg[2](null)。这个初始化失败的logger会被实例化为空对象，根本无法绑定RollingFile Appender，最终导致配置的HTML日志文件虽然被正常创建，但完全没有日志写入。
结构校验的坑：Log4j2的JSON解析器对属性大小写、节点嵌套结构的校验非常严格，很多场景下把name写成大写Name、把属性放在错误的嵌套层级时，解析器读不到对应字段，也会触发上述的null参数报错，和logger工厂调用失败的异常栈完全匹配。
配置逻辑错配：你当前把root logger仅绑定了STDOUT控制台Appender，就算单独的业务logger配置修复正常，也会出现「只有匹配了单独logger规则的日志才会写入HTML文件，其余日志仅输出控制台」的割裂效果，无法实现全局日志双端输出的需求。

修复步骤

第一步：清理无效logger配置，补全必填属性
完全删除之前因为参数缺失被初始化为空对象的无效logger节点，替换为带合法名称的配置片段参考：

"loggers": {
  // 非root logger必须显式填写name字段，不能留空、不能传null
  "logger": [
    {
      "name": "com.yourproject",
      "level": "info",
      "AppenderRef": [
        {"ref": "File"}
      ]
    }
  ],
  // 调整root logger绑定逻辑，实现全局双端输出
  "root": {
    "level": "info",
    "AppenderRef": [
      // 同时绑定控制台、HTML滚动文件两个Appender，无需额外配置单独logger就能覆盖全局日志
      {"ref": "STDOUT"},
      {"ref": "File"}
    ]
  }
}

第二步：校验RollingFile Appender的HTML格式配置
确保名为File的RollingFile配置中，layout类型为专门的Html格式，文件路径配置为当前进程有写入权限的目录，参考配置片段：

"File": {
  "type": "RollingFile",
  "fileName": "logs/info-app.html",
  "filePattern": "logs/info-app-%d{yyyy-MM-dd}-%i.html",
  "layout": {
    "type": "Html",
    "contentType": "text/html; charset=UTF-8"
  },
  "Policy": {
    "type": "SizeBasedTriggeringPolicy",
    "size": "10MB"
  }
}

第三步：全量校验配置的JSON结构合法性
检查所有属性的大小写、嵌套层级是否匹配Log4j2的解析规则，避免因为解析逻辑读不到属性，再次触发null参数的初始化报错。
配置调整完成后重启项目，即可达成目标效果：日志同时输出到控制台、按规则滚动写入HTML格式的日志文件，之前生成的空HTML日志文件会正常开始写入内容。

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