Log4j2高级日志过滤：包级与类级正则筛选的实现与陷阱

com.app.package.one
  - class1.java
  - class2.java
  - class3.java
  - class4.java

com.app.package.two
  - class5.java
  - class6.java
  - class7.java
  - class8.java

<Logger name="com.app.package" level="error">
    <RegexFilter regex=".*(?i)exception(?-i).*" onMatch="ACCEPT" onMismatch="DENY"/>
</Logger>

<Logger name="com.app.package.two.class7" level="error">
    <RegexFilter regex=".*(?i)exception(?-i).* | .*(?i)sometext(?-i).*" onMatch="ACCEPT" onMismatch="DENY"/>
</Logger>

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <Appenders>
        <!-- 定义一个控制台Appender，用于输出日志 -->
        <Console name="LogToConsole" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
        </Console>
    </Appenders>

    <Loggers>
        <!--
            1. 包级通用Logger配置：
               - 针对com.app.package及其子包下的所有类。
               - 级别为ERROR。
               - 使用RegexFilter过滤，仅接受消息中包含“exception”（不区分大小写）的日志。
               - 将匹配到的日志发送到LogToConsole Appender。
        -->
        <Logger name="com.app.package" level="error" additivity="false">
            <RegexFilter regex=".*(?i)exception(?-i).*" onMatch="ACCEPT" onMismatch="DENY"/>
            <AppenderRef ref="LogToConsole"/>
        </Logger>

        <!--
            2. 特定类Logger配置：
               - 针对com.app.package.two.class7这个特定类。
               - 级别为ERROR。
               - 使用RegexFilter过滤，接受消息中包含“exception”或“sometext”（不区分大小写）的日志。
               - 注意正则表达式中“|”前后无空格。
               - 将匹配到的日志发送到LogToConsole Appender。
               - additivity="false"确保此Logger的日志不会再向上级Logger传递，避免重复处理或不必要的过滤。
        -->
        <Logger name="com.app.package.two.class7" level="error" additivity="false">
            <RegexFilter regex=".*(?i)exception(?-i).*|.*(?i)sometext(?-i).*" onMatch="ACCEPT" onMismatch="DENY"/>
            <AppenderRef ref="LogToConsole"/>
        </Logger>

        <!-- 根Logger配置，捕获未被特定Logger处理的日志，通常用于默认输出或兜底 -->
        <Root level="info">
            <AppenderRef ref="LogToConsole"/>
        </Root>
    </Loggers>
</Configuration>

// com/app/package/one/Class1.java
package com.app.package.one;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

public class Class1 {
    private static final Logger logger = LogManager.getLogger(Class1.class);

    public void doSomething() {
        logger.info("This is an info message from Class1."); // 不会输出
        logger.error("An unexpected exception occurred in Class1."); // 会输出 (符合包级exception过滤)
        logger.error("Just an error message from Class1."); // 不会输出 (不含exception)
    }
}

// com/app/package/two/Class7.java
package com.app.package.two;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

public class Class7 {
    private static final Logger logger = LogManager.getLogger(Class7.class);

    public void performTask() {
        logger.info("Info message from Class7."); // 不会输出
        logger.error("Processing error with an exception in Class7."); // 会输出 (符合类级exception过滤)
        logger.error("A critical sometext event happened in Class7."); // 会输出 (符合类级sometext过滤)
        logger.error("Another error message from Class7."); // 不会输出 (不含exception或sometext)
    }
}

// MainApp.java (用于运行测试)
import com.app.package.one.Class1;
import com.app.package.two.Class7;

public class MainApp {
    public static void main(String[] args) {
        new Class1().doSomething();
        new Class7().performTask();
    }
}

HH:mm:ss.SSS [main] ERROR com.app.package.one.Class1 - An unexpected exception occurred in Class1.
HH:mm:ss.SSS [main] ERROR com.app.package.two.Class7 - Processing error with an exception in Class7.
HH:mm:ss.SSS [main] ERROR com.app.package.two.Class7 - A critical sometext event happened in Class7.