Java输出JSON日志需日志框架支持JSON编码器并正确配置：Logback配合logback-json-encoder，Log4j2使用JsonLayout；均支持MDC注入自定义字段，推荐配置方式而非手动拼接。
Java 中输出 JSON 格式日志，核心是让日志框架（如 Logback、Log4j2）将日志事件序列化为结构化 JSON，而非默认的文本格式。这需要两方面配合：日志框架支持 JSON 编码器 + 正确配置（或编程式设置）。
使用 Logback + logback-json-encoder
Logback 是最常用的日志框架之一，搭配 logback-json-encoder 可轻松输出 JSON 日志。
- 添加 Maven 依赖：
<groupId>net.logstash.logback</groupId>
<artifactId>logstash-logback-encoder</artifactId>
<version>7.4</version>
</dependency>
- 在
logback-spring.xml或logback.xml中配置 JSON encoder：
<encoder class="net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder">
<providers>
<timestamp/>
<version/>
<message/>
<loggerName/>
<level/>
<stackTrace/>
<pattern>
<pattern>"thread":"%thread","service":"myapp","env":"${spring.profiles.active:-dev}"</pattern>
</pattern>
</providers>
</encoder>
</appender>
- 支持自定义字段（如 traceId、userId），可通过 MDC（Mapped Diagnostic Context）注入后自动写入 JSON：
代码中：
MDC.put("traceId", "abc123");
MDC.put("userId", "u789");
log.info("User login succeeded");
→ 输出 JSON 中会自动包含 "traceId":"abc123","userId":"u789"
使用 Log4j2 + Jackson JSON Layout
Log4j2 原生支持 JSON 输出，通过 JsonLayout 即可实现。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- Maven 依赖（确保有 Jackson 支持）：
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
</dependency>
- log4j2.xml 配置示例：
<Console name="Console" target="SYSTEM_OUT">
<JsonLayout compact="true" eventEol="true" />
</Console>
</Appenders>
- 支持添加额外字段（如服务名、版本）：
<KeyValuePair key="service" value="myapp" />
<KeyValuePair key="version" value="1.2.0" />
</JsonLayout>
手动构造 JSON 日志（不推荐，仅作补充）
若因限制无法使用结构化日志框架，也可用 Jackson/Gson 手动拼装，但会丢失日志级别、时间戳、线程等上下文信息，且难以与 MDC 集成。
立即学习“Java免费学习笔记（深入）”；
- 示例（Jackson）：
Map<String, Object> log = new HashMap<>();
log.put("level", "INFO");
log.put("message", "Order processed");
log.put("orderId", 1001);
log.put("timestamp", Instant.now());
log.info(mapper.writeValueAsString(log));
- 缺点明显：绕过日志框架能力，无法统一管理格式、异步、过滤、滚动等；不建议生产使用。
关键注意事项
- 避免日志内容含非法 JSON 字符：如未转义的双引号、换行符。Logback JSON encoder 和 Log4j2 JsonLayout 默认会处理，但手动拼接时需注意。
- 性能影响：JSON 序列化比纯文本略重，但在现代 JVM 上通常可忽略；高吞吐场景可启用异步 Appender（如 AsyncAppender）缓解。
- 与链路追踪集成：结合 Sleuth 或 Micrometer Tracing 时，traceId/spanId 会自动注入 MDC，JSON encoder 可直接捕获并输出。
-
日志采集兼容性：确保 ELK、Loki、Datadog 等后端能正确解析 JSON 字段；建议用
compact="true"减少空格提升解析效率。
