在java日志记录中，避免字符串拼接的核心做法是使用slf4j等支持占位符的日志框架，将参数作为独立变量传入，而不是使用`+`运算符或`string.format`。这样做的好处是，如果当前日志级别被禁用（例如debug级别下打印info日志），日志框架会直接跳过字符串的构建过程，从而节省cpu和内存开销。具体实现时，只需在日志消息中使用`{}`作为占位符，并在其后依次传入对应的参数即可。
为什么字符串拼接会导致性能问题
当使用`+`号进行字符串拼接时，Java编译器会在运行时创建StringBuilder对象并执行append操作，即使该日志最终不会输出。这种不必要的计算在高频调用场景下会成为性能瓶颈。相比之下，占位符机制允许日志框架先检查日志级别，只有在级别匹配时才进行参数替换。
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class LogExample {
private static final Logger logger = LoggerFactory.getLogger(LogExample.class);
public void processUser(String userId, int age) {
// 错误做法：始终执行拼接
logger.debug("Processing user: " + userId + " with age: " + age);
// 正确做法：使用占位符
logger.debug("Processing user: {} with age: {}", userId, age);
}
}
上述代码展示了两种写法的对比。在错误做法中，无论DEBUG是否开启，`userId`和`age`都会被转换为字符串并拼接。在正确做法中，只有当DEBUG级别开启时，SLF4J才会调用`String.valueOf()`并将参数填入占位符。预期结果是，在INFO级别下运行程序，第一种写法会产生垃圾回收压力，而第二种写法几乎无额外开销。
如何处理复杂对象或条件日志
对于复杂对象，直接传入对象引用即可，日志框架会自动调用其`toString()`方法。若需根据条件决定是否记录日志，应使用`isDebugEnabled()`等方法进行显式检查，或者将条件逻辑放在日志调用之外。此外，占位符不仅适用于基本类型，也适用于任何实现了`toString()`的对象。
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class ComplexLogExample {
private static final Logger logger = LoggerFactory.getLogger(ComplexLogExample.class);
public void handleRequest(Object request) {
// 复杂对象直接作为参数
logger.trace("Received request object: {}", request);
// 条件日志：仅在DEBUG开启且满足条件时记录
if (logger.isDebugEnabled()) {
logger.debug("Detailed info for request: {}", request.toString());
}
}
}
这段代码演示了如何处理复杂对象。在`trace`级别调用中，`request`对象被直接传入，框架会在需要时调用其`toString()`。在`debug`级别的示例中，使用了`isDebugEnabled()`进行预检查，这是一种更传统的避免拼接的方式，但在现代SLF4J实践中，直接使用占位符更为简洁。注意，`request.toString()`在条件判断内部调用，确保了只有在DEBUG开启时才会执行转换。
占位符数量不匹配时会发生什么
当占位符的数量与传入参数的数量不一致时，SLF4J会抛出`MessageFormatFormatException`异常。这通常发生在复制粘贴日志模板后忘记修改参数列表的情况下。因此，保持占位符与参数一一对应是编写健壮日志代码的关键。如果确实需要记录大量动态信息，可以考虑使用JSON格式序列化对象，但需注意序列化本身的开销。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
