如何在Log4j日志消息中高效限制字符串长度？

针对你提到的问题——既想在调试日志中截断SQL字符串以节省空间，又不想在调试级别未启用时执行不必要的substring()操作，这里有两种更优雅的替代方案：

方案1：使用Log4j 2的Lambda延迟求值特性（推荐） #

Log4j 2.4及以上版本支持通过Lambda表达式实现延迟消息构造，只有当目标日志级别（这里是DEBUG）启用时，Lambda中的代码才会执行。

示例代码：

logger.debug("Neither {} nor {} in {}", 
    pattern1, pattern2,
    () -> sql.substring(0, idx));

原理：第三个参数传入的是Supplier<String>类型的Lambda，Log4j会在确定要输出日志时才调用get()方法执行sql.substring(0, idx)，完全避免了调试关闭时的无效字符串构造。

方案2：自定义截断字符串包装类（兼容旧版本Log4j） #

如果使用的是Log4j 1.x或不支持Lambda的旧版Log4j 2，可以通过自定义一个轻量包装类，利用toString()方法的延迟调用特性：

class TruncatedString {
    private final String original;
    private final int maxLength;

    public TruncatedString(String original, int maxLength) {
        this.original = original;
        this.maxLength = Math.max(0, maxLength); // 避免负数长度
    }

    @Override
    public String toString() {
        if (original == null) return null;
        int actualLength = Math.min(maxLength, original.length());
        return original.substring(0, actualLength);
    }
}

调用方式：

logger.debug("Neither {} nor {} in {}", 
    pattern1, pattern2,
    new TruncatedString(sql, idx));

原理：TruncatedString的toString()方法只有在Log4j需要格式化输出时才会被调用，调试级别未启用时不会执行截断操作。

为什么%.*s无法生效？ #

Log4j的{}占位符基于自身的消息格式化逻辑，并不兼容C语言printf的格式说明符（如%.*s），因此这种写法无法被Log4j解析，只会将%.*s作为普通字符串输出。

内容的提问来源于stack exchange，提问作者Mikhail T.