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

在 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"}
相关推荐
FungLeo3 小时前
FengCMS · PHP+MySQL 升级实录 · 内容写入一致性:锁等待超时与跨模型子树删除竞态
开发语言·mysql·php·工程实践·fengcms
谙弆悕博士5 小时前
多智能体架构详解:市场拍卖式架构(Market-based / 竞价协商)
开发语言·架构·去中心化·多智能体·智能体·拍卖架构
ShineWinsu5 小时前
对于Qt:QMessageBox的解析
开发语言·c++·qt·面试·客户端·qmessagebox·消息对话框
承渊政道6 小时前
【Python编程快速上手—让繁琐工作自动化】(列表:把数据排成队,从下标取值到深拷贝)
开发语言·python·pycharm·自动化·列表
tryCbest6 小时前
Python 爬虫从入门到实战(一):基础篇——从零写出第一个爬虫
开发语言·爬虫·python
多加点辣也没关系7 小时前
JavaScript|第40章:JavaScript 工程化实践
开发语言·javascript·ecmascript
吃我一窝jio9 小时前
Java Bug复盘与性能优化实战
java·开发语言·笔记
Evand J11 小时前
【MATLAB例程】基于APF的多无人机动态路径规划与避障仿真。避碰及安全性能分析。附完整代码的下载链接
开发语言·matlab·无人机
鲸渔11 小时前
【AI Agent系列课程13-Python 基础13】JSON 读写:结构化数据交换基础
开发语言·python·json·ai编程
Highcharts.js16 小时前
Highcharts漏斗图表使用配置指南
java·开发语言·javascript·信息可视化·highcharts·漏斗图