在java日志记录中，使用占位符 {} 的核心做法是调用日志框架提供的带参方法（如 info(string format, object... args)），将占位符作为字符串模板传入，并将实际值按顺序作为后续参数传入。这样做的好处是日志框架会在输出前进行格式化，且只有在日志级别满足条件时才会执行参数对象的 tostring() 方法，从而避免不必要的性能开销。例如，调用 logger.info("user {} logged in", userid) 即可安全地记录用户id。
如何正确使用占位符避免性能陷阱
正确使用的关键在于区分字符串拼接与占位符调用的差异。如果使用字符串拼接 "User " + userId + " logged in"，无论日志是否开启，userId.toString() 都会执行并创建新的字符串对象。而使用占位符 "User {} logged in", userId，日志框架会先检查当前级别，若低于设定级别则直接返回，不执行任何格式化操作。因此，务必确保所有动态值都通过参数传递，而不是在消息模板中拼接。
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class LogPlaceholderDemo {
private static final Logger logger = LoggerFactory.getLogger(LogPlaceholderDemo.class);
public void processUser(String userId) {
// 错误示范：始终执行 toString 和拼接
// logger.info("Processing user: " + userId);
// 正确示范：仅在 INFO 级别开启时执行 toString
if (logger.isInfoEnabled()) {
logger.info("Processing user: {}", userId);
}
}
public static void main(String[] args) {
LogPlaceholderDemo demo = new LogPlaceholderDemo();
demo.processUser("U12345");
}
}
占位符数量不匹配或类型错误时会发生什么
当占位符数量与实际参数数量不一致，或参数类型无法转换为字符串时，日志框架通常会抛出异常或产生不可预期的结果。SLF4J 等主流框架在运行时会对参数进行检查，如果占位符多于参数，剩余占位符可能原样输出；如果少于参数，多余参数可能被忽略或导致格式化错误。此外，如果传入的对象 toString() 实现不佳，可能导致日志输出过长或阻塞。因此，必须保证占位符与参数一一对应，且参数应为基本类型或轻量级对象。
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class LogErrorDemo {
private static final Logger logger = LoggerFactory.getLogger(LogErrorDemo.class);
public void demonstrateErrors() {
String name = "Alice";
int age = 30;
// 情况1：占位符少于参数（多余参数被忽略）
logger.info("Name: {}, Age: {}", name);
// 输出: Name: Alice, Age: {}
// 情况2：占位符多于参数（未提供值的占位符原样输出）
logger.info("Name: {}, Age: {}, City: {}", name, age);
// 输出: Name: Alice, Age: 30, City: {}
// 情况3：类型不匹配（通常不会报错，但 toString 可能不符合预期）
logger.info("Value: {}", new Object());
// 输出: Value: java.lang.Object@hashcode
}
public static void main(String[] args) {
LogErrorDemo demo = new LogErrorDemo();
demo.demonstrateErrors();
}
}
基于日志级别开关的具体行为验证
基于程序中 logger.isInfoEnabled() 这一具体条件，当该条件为 false 时，即使传入的参数包含复杂计算或远程调用，也不会被执行。这验证了占位符机制的惰性求值特性。开发者可以利用这一点，在日志消息中嵌入复杂的调试信息，而无需手动包裹 if 判断，只要确保这些信息通过占位符参数传递即可。例如，记录一个大型对象的哈希值或状态快照，仅在 DEBUG 级别开启时才触发其生成逻辑。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
