Log4j2 默认将 StringMapMessage 中的 JsonElement 序列化为字符串，无法自动还原为嵌套 JSON 对象；官方暂不支持该能力，但可通过自定义事件解析器（Custom Event Resolver）在 JsonTemplateLayout 中精准控制字段序列化逻辑。
log4j2 默认将 `stringmapmessage` 中的 `jsonelement` 序列化为字符串，无法自动还原为嵌套 json 对象；官方暂不支持该能力，但可通过自定义事件解析器（custom event resolver）在 `jsontemplatelayout` 中精准控制字段序列化逻辑。
在 Log4j2 的 JsonTemplateLayout 中，标准事件解析器（如 map、context、timestamp）均以字符串化方式处理值——即使传入的是 com.google.gson.JsonElement 或已序列化的 JSON 字符串（如 ""{\"visitId\":\"ABCDEFG\"}""），也会被原样转义写入，导致日志中出现双引号包裹的 JSON 字符串（如 "request":"{"visitId":"ABCDEFG"}"），而非期望的结构化嵌套对象（如 "request":{"visitId":"ABCDEFG"}）。
根本原因在于：Log4j2 的内置 map 解析器仅执行 Object.toString()，并不识别或反序列化 JSON 格式字符串。官方当前（截至 Log4j 2.20+）未提供开箱即用的 JSON 解析模式或 stringified: false 深度解析能力，相关需求已在 JIRA LOG4J2-3082 中提出，但尚未合入主线。
✅ 正确解法：实现自定义 EventResolver
通过继承 org.apache.logging.log4j.core.layout.json.template.resolver.EventResolver，重写 resolve(LogEvent, JsonWriter) 方法，可直接操作底层 JsonWriter，对指定字段（如 "request"）进行手动 JSON 写入：
public class JsonElementResolver implements EventResolver {
@Override
public void resolve(LogEvent event, JsonWriter writer) throws IOException {
final Message message = event.getMessage();
if (message instanceof StringMapMessage) {
final StringMap map = ((StringMapMessage) message).getParameters();
final JsonElement requestElement = (JsonElement) map.get("request");
if (requestElement != null && !requestElement.isJsonNull()) {
// 直接写入原始 JSON 结构，不加引号、不转义
writer.writeRawValue(requestElement.toString());
return;
}
}
// 回退：写入 null 或跳过
writer.writeNull();
}
}
注册该解析器后，在 log4j2.xml 中配置模板字段：
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
<jsontemplatelayout><eventtemplateadditionalfield key="request" value='{"$resolver": "jsonElement"}'></eventtemplateadditionalfield><!-- 其他字段保持 map 解析 --><eventtemplateadditionalfield key="otherField" value='{"$resolver": "map", "field": "otherField"}'></eventtemplateadditionalfield></jsontemplatelayout>
并在 log4j2.xml 的 <configuration></configuration> 根节点下声明解析器扩展：
<configuration packages="com.yourpackage.resolvers"><!-- ... appenders & loggers --></configuration>
⚠️ 注意事项：
- 自定义解析器需确保线程安全（
resolve()方法不可持有共享可变状态）； -
JsonElement.toString()输出不含换行缩进，符合日志紧凑性要求；若需格式化，可改用new GsonBuilder().setPrettyPrinting().create().toJson()，但会增加日志体积； - 避免在
resolve()中执行耗时操作（如网络调用、文件读取），否则阻塞日志线程； - 若
request字段可能为null或非JsonElement类型，务必做类型校验与空值防护，防止ClassCastException或 NPE。
总结：Log4j2 的灵活性体现在其可扩展架构上。当标准解析器无法满足结构化 JSON 嵌套需求时，自定义 EventResolver 是最轻量、最可控的解决方案——它绕过字符串序列化环节，直抵 JSON 输出流，完美复现原有自定义日志框架的嵌套行为。
