应避免在日志占位符中直接调用arrays.tostring()，因其会破坏链路追踪上下文、导致mdc丢失或npe；正确做法是使用supplier延迟求值、json序列化数组、定制logback converter或结合opentelemetry语义日志增强。
直接在日志中调用 Arrays.toString() 会破坏链路追踪上下文的结构化输出，容易导致日志解析失败、MDC信息丢失或追踪ID被截断。正确做法是将数组内容安全转为字符串，并确保不干扰现有日志框架（如Logback/Log4j2）与链路追踪组件（如SkyWalking、Sleuth、OpenTelemetry）的集成逻辑。
避免在占位符中直接调用 toString()
错误写法：log.info("request params: {}", Arrays.toString(params));
问题：SLF4J 的 {} 占位符机制会提前执行 Arrays.toString()，若参数含敏感对象或空引用，可能抛出 NPE 或触发非预期 toString()；更严重的是，某些链路追踪插件依赖日志事件的原始参数做上下文注入，提前字符串化会切断这一链路。
- 改用延迟求值方式：让日志框架在真正输出时才调用 toString，保持参数原始类型
- 推荐写法：
log.info("request params: {}", () -> Arrays.toString(params));（SLF4J 1.8+ 支持 Supplier） - 若版本较旧，可封装为工具方法：
LogUtils.arrayToString(params)，内部做空值和类型校验
统一日志格式适配链路追踪字段
多数链路追踪方案（如 Sleuth）会自动向 MDC 注入 traceId、spanId 等字段。需确保 Arrays.toString() 输出不污染这些字段，也不破坏 JSON 日志结构。
- 若使用 JSON 日志（如 LogstashEncoder），应将数组转为标准 JSON 数组字符串，而非
[a, b, c]这类易解析错误的格式 - 建议用 Jackson 或 Gson 序列化：
objectMapper.writeValueAsString(params)，它天然支持 null 安全和嵌套结构 - 对基础类型数组（int[]、String[]），仍可用
Arrays.toString()，但需包裹在 JSON value 中："params": "['a','b']"
定制 Logback Converter 支持数组自动格式化
在 logback-spring.xml 中注册自定义 converter，使 %X{traceId} 和 %msg 同时生效，且数组参数自动美化输出。
- 继承
ClassicConverter，重写convert()方法，检测参数是否为数组，调用Arrays.toString()并转义双引号 - 配置示例：
<conversionrule conversionword="array" converterclass="com.example.ArraySafeConverter"></conversionrule> - 日志模板中写：
%d{HH:mm:ss.SSS} [%array] [%X{traceId}] - %m%n - 该方式不影响原有 MDC 和异步日志性能，所有数组输出风格统一
配合 OpenTelemetry 做语义日志增强
当使用 OpenTelemetry 日志导出器时，日志事件会被转为 OTLP LogRecord。此时 Arrays.toString() 的结果应作为 body 字段值，而非混入属性（attributes）。
- 禁止把数组 toString 结果塞进 attributes，否则可能触发采样限流或字段长度截断
- 正确方式：保留原始数组为日志事件参数，在日志处理器中统一序列化为 body 文本
- 可结合 Micrometer 的
ObservationRegistry，在日志前钩住 observation context，注入 trace 相关元数据 - 示例：
log.atInfo().log("query executed with ids: {}", ids);—— ids 是 Long[]，由日志桥接器自动转为安全字符串
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
