使用Log4j2的JsonTemplateLayout时日志参数缺失问题求助

首先得明确：JsonTemplateLayout和PatternLayout的工作逻辑完全不同，你试图用Pattern里的方式指定参数肯定行不通——前者是基于JSON模板来构建日志结构，默认模板只包含基础字段（比如时间、级别、消息等），你需要的额外参数得通过模板配置或者显式添加的方式纳入进去。

下面给你几个可行的解决方案，结合你的现有配置来调整：

方案1：通过配置直接添加额外字段 #

如果你的缺失参数是固定的上下文信息（比如类名、方法名、行号这类，或者自定义的业务参数），可以直接在JsonTemplateLayout下添加KeyValuePair来指定：

appender.rolling.layout.type = JsonTemplateLayout
# 添加你需要的额外字段，比如类名、方法名、行号
appender.rolling.layout.additionalFields.type = KeyValuePair
appender.rolling.layout.additionalFields.key = className
appender.rolling.layout.additionalFields.value = %C{0}
appender.rolling.layout.additionalFields.key = methodName
appender.rolling.layout.additionalFields.value = %M
appender.rolling.layout.additionalFields.key = lineNumber
appender.rolling.layout.additionalFields.value = %L

这里用的%C{0}、%M、%L就是你之前在Pattern里用的占位符，JsonTemplateLayout支持通过这种方式直接注入这些日志上下文参数。

方案2：自定义JSON模板 #

如果需要更灵活的结构控制，你可以自定义一个JSON模板文件，然后让JsonTemplateLayout加载它。比如创建一个log-template.json文件：

{
  "timestamp": { "$resolver": "timestamp", "pattern": { "format": "yyyy-MM-dd'T'HH:mm:ss.SSSZ" } },
  "level": { "$resolver": "level" },
  "logger": { "$resolver": "logger", "field": "name" },
  "message": { "$resolver": "message" },
  "className": { "$resolver": "pattern", "pattern": "%C{0}" },
  "methodName": { "$resolver": "pattern", "pattern": "%M" },
  "lineNumber": { "$resolver": "pattern", "pattern": "%L" },
  "thread": { "$resolver": "thread" }
}

然后在配置里指定模板路径：

appender.rolling.layout.type = JsonTemplateLayout
appender.rolling.layout.templateLocation = log-template.json

这种方式能完全自定义输出的JSON结构，想加什么字段就加什么。

方案3：检查MDC参数是否正确传递 #

如果你的缺失参数是放在ThreadContext（也就是MDC）里的，JsonTemplateLayout默认不会自动包含这些字段，你需要在模板里添加MDC解析器：
在自定义模板里加上：

"mdc": { "$resolver": "mdc" }

或者通过配置直接添加MDC里的指定字段：

appender.rolling.layout.additionalFields.type = KeyValuePair
appender.rolling.layout.additionalFields.key = userId
appender.rolling.layout.additionalFields.value = ${ctx:userId}

这里${ctx:userId}就是获取MDC里的userId参数。

最后提醒下：修改配置后要确保Log4j2能正确加载配置文件，重启应用后测试日志输出，看看缺失的参数是否已经包含进去了。

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