Java中基于标记的日志过滤方案咨询（限java.util与SLF4J）

可以实现，以下是无需大幅改动现有架构的具体方案：

一、基础配置：SLF4J与JUL的桥接 #

先确保项目引入正确的SLF4J依赖，实现SLF4J API与java.util.logging（JUL）的桥接，既能保留原有JUL的配置，又能利用SLF4J的特性添加标记：

• Maven依赖（适配主流构建工具）：

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>1.7.36</version> <!-- 替换为最新稳定版即可 -->
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-jdk14</artifactId>
    <version>1.7.36</version>
</dependency>

该配置让SLF4J的日志请求最终通过JUL输出，完全兼容原有JUL日志系统的运行逻辑。

二、添加日志标记的两种方案 #

1. 用SLF4J MDC实现全局/请求级标记（推荐，改动最小） #

SLF4J的MDC（映射诊断上下文）是线程绑定的上下文容器，适合添加业务标记、TraceID等，无需修改原有日志代码的结构，只需在合适时机注入标记：

• 注入标记（示例：请求入口、业务方法启动时）：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.slf4j.MDC;

public class OrderService {
    private static final Logger logger = LoggerFactory.getLogger(OrderService.class);

    public void processOrder(String orderId) {
        // 添加业务标记
        MDC.put("business_tag", "order_process");
        try {
            logger.info("开始处理订单: {}", orderId);
            // 业务逻辑执行...
        } finally {
            // 务必移除标记，避免线程复用导致的内存泄漏
            MDC.remove("business_tag");
        }
    }
}

• 修改JUL日志格式，让标记出现在输出中：
  找到项目中的logging.properties，配置SimpleFormatter格式，加入MDC标记占位符%X{business_tag}：

java.util.logging.SimpleFormatter.format=%1$tY-%1$tm-%1$td %1$tH:%1$tM:%1$tS %4$s %2$s %5$s [tag=%X{business_tag}]%n

修改后日志输出会带上[tag=order_process]这类标记内容。

2. 扩展JUL LogRecord添加自定义标记（适合局部改造） #

如果不想全量切换到SLF4J API，可直接扩展JUL的LogRecord类，添加自定义标记字段：

import java.util.logging.Level;
import java.util.logging.LogRecord;

public class TaggedLogRecord extends LogRecord {
    private String customTag;

    public TaggedLogRecord(Level level, String msg) {
        super(level, msg);
    }

    public String getCustomTag() {
        return customTag;
    }

    public void setCustomTag(String customTag) {
        this.customTag = customTag;
    }
}

• 使用时替换原有日志记录方式：

import java.util.logging.Logger;

public class PaymentService {
    private static final Logger logger = Logger.getLogger(PaymentService.class.getName());

    public void processPayment(String payId) {
        TaggedLogRecord record = new TaggedLogRecord(Level.INFO, "处理支付请求: " + payId);
        record.setCustomTag("payment_process");
        logger.log(record);
    }
}

三、实现标记过滤 #

1. 基于MDC标记的过滤 #

自定义JUL的Filter，通过MDC中的标记值判断是否输出日志：

import org.slf4j.MDC;
import java.util.logging.Filter;
import java.util.logging.LogRecord;

public class MdcTagFilter implements Filter {
    // 允许输出的标记，可通过配置文件传入
    private String allowedTag;

    public MdcTagFilter(String allowedTag) {
        this.allowedTag = allowedTag;
    }

    @Override
    public boolean isLoggable(LogRecord record) {
        String currentTag = MDC.get("business_tag");
        // 允许标记匹配的日志输出，无标记时可自行决定是否放行
        return allowedTag == null || allowedTag.equals(currentTag);
    }
}

• 在logging.properties中配置过滤器到指定Handler：

handlers=java.util.logging.ConsoleHandler
java.util.logging.ConsoleHandler.filter=com.yourcompany.MdcTagFilter

若需动态指定允许的标记，可在过滤器中读取系统参数或配置文件：

public MdcTagFilter() {
    this.allowedTag = System.getProperty("log.allowed.tag");
}

2. 基于自定义LogRecord的过滤 #

针对TaggedLogRecord实现过滤器：

import java.util.logging.Filter;
import java.util.logging.LogRecord;

public class CustomTagFilter implements Filter {
    private String allowedTag;

    public CustomTagFilter(String allowedTag) {
        this.allowedTag = allowedTag;
    }

    @Override
    public boolean isLoggable(LogRecord record) {
        if (record instanceof TaggedLogRecord) {
            TaggedLogRecord taggedRecord = (TaggedLogRecord) record;
            return allowedTag == null || allowedTag.equals(taggedRecord.getCustomTag());
        }
        // 非标记日志默认放行，可根据需求调整规则
        return true;
    }
}

同样在logging.properties中配置该过滤器即可生效。

关键注意事项 #

• MDC是线程绑定的，异步线程中需手动传递上下文：如果业务包含异步任务，要在提交线程前复制MDC上下文，在异步线程中恢复，示例：

Map<String, String> mdcContext = MDC.getCopyOfContextMap();
CompletableFuture.runAsync(() -> {
    MDC.setContextMap(mdcContext);
    try {
        // 异步业务逻辑与日志记录
    } finally {
        MDC.clear();
    }
});

• 尽量保留原有JUL的配置体系，避免替换底层日志实现，减少架构改动范围。

内容的提问来源于stack exchange，提问作者Sweta Dhanuk