log.info中使用多个占位符{}问题

qq_366086222026-01-15 12:42

在 Java 中使用 log.info()（如 SLF4J、Logback、Log4j2 等日志框架）时，多个占位符 {} 的使用非常常见且安全，但需要注意以下几点以避免常见错误。

java 复制代码

//正确用法：多个 {} 按顺序匹配参数

log.info("用户 {} 在 {} 执行了操作 {}, 耗时 {} ms", userId, timestamp, action, duration);

//问题 1：想输出字面量 {}，但被当作占位符
log.info("配置项 {{timeout}} = {}", timeout); 
// 期望输出：{timeout} = 5000
// 实际输出：{timeout = 5000  （左花括号被吃掉！）

//解决：用双大括号 {{}} 转义：
log.info("配置项 {{timeout}} = {}", timeout); 
// 输出：{timeout} = 5000 


//问题 2：参数为 null 或复杂对象，输出不友好
log.info("请求参数: {}", requestObject); 
// 可能输出：com.xxx.Request@1a2b3c（默认 toString）
//使用 JSON 序列化（如 Jackson）：
log.info("请求参数: {}", JSON.toJSONString(requestObject));


//问题 3：异常信息未正确传递
// 错误：异常作为普通参数，不会打印堆栈
log.info("处理失败: {}", e); 

// 正确：异常必须放在**最后一个参数**，且不要用 {}
log.info("处理失败", e); 
// 或
log.info("用户 {} 处理失败", userId, e); // e 是最后一个参数
//规则：只有当最后一个参数是 Throwable 时，日志框架才会打印堆栈跟踪。



// SLF4J 不支持{0}, {1} 这种格式（那是 MessageFormat 的语法）！
// ❌ 错误！SLF4J 会原样输出 "{0}"
log.info("用户 {0} 操作 {1}", userId, action);

最佳实践总结

示例：完整正确用法

java 复制代码

String userId = "U1001";
String action = "支付";
long duration = 125L;
Exception ex = new RuntimeException("网络超时");

// 正常多参数
log.info("用户 {} 执行 {} 耗时 {}ms", userId, action, duration);

// 带异常（ex 必须是最后一个）
log.info("用户 {} 操作失败", userId, ex);

// 输出字面 {}
log.info("JSON 模板: {{\"user\": \"{}\"}}", userId);
// 输出：JSON 模板: {"user": "U1001"}