Android中编译依赖的Log4j日志配置无法加载问题

一、手动加载assets中的配置文件 #

Log4j2默认不会自动识别Android的assets目录，需在应用启动阶段手动读取并加载配置：

在自定义Application类中添加如下代码：

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.core.LoggerContext;
import org.apache.logging.log4j.core.config.ConfigurationSource;
import org.apache.logging.log4j.core.config.Configurator;
import java.io.InputStream;

public class MyApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        initLog4j();
    }

    private void initLog4j() {
        try (InputStream is = getAssets().open("log4j2.xml")) {
            ConfigurationSource source = new ConfigurationSource(is);
            LoggerContext context = (LoggerContext) LogManager.getContext(false);
            context.start(source);
            Configurator.initialize(null, source);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

确保log4j2.xml放在assets根目录，文件名完全匹配。

二、替换依赖解决配置忽略与Lambda报错 #

第三方的com.celeral:log4j2-android会覆盖Log4j2默认的配置加载逻辑，导致自定义配置失效；移除它又会触发LambdaMetafactory兼容性问题，改用官方适配的依赖即可解决：

1. 在Android项目的build.gradle中添加官方的Android兼容依赖，同时确保Log4j版本为2.24.1及以上：

implementation 'org.apache.logging.log4j:log4j-api:2.24.1'
implementation 'org.apache.logging.log4j:log4j-core:2.24.1'
implementation 'org.apache.logging.log4j:log4j-android:2.24.1'

官方的log4j-android模块专门适配Android环境，既不会忽略自定义配置，也修复了Lambda相关的字节码兼容性问题。

2. 如果你的共享Java依赖中包含Log4j相关包，需要排除冲突：

implementation('your-shared-java-library') {
    exclude group: 'org.apache.logging.log4j', module: 'log4j-core'
    exclude group: 'org.apache.logging.log4j', module: 'log4j-api'
}

三、验证配置是否生效 #

在log4j2.xml中配置Root级别为INFO，然后在代码中打印不同级别的日志，通过Logcat验证：

<Configuration status="INFO">
    <Appenders>
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
        </Console>
    </Appenders>
    <Loggers>
        <Root level="INFO">
            <AppenderRef ref="Console"/>
        </Root>
    </Loggers>
</Configuration>

启动应用后，DEBUG级别的日志不会出现在Logcat中，INFO及以上级别日志正常输出即说明配置生效。

四、额外兼容说明 #

• 确保项目的minSdkVersion不低于21，Log4j2 2.x版本对Android 21以下的系统兼容性较差。
• 若开启代码混淆，需在proguard-rules.pro中添加Log4j2的混淆规则：

-keep class org.apache.logging.log4j.** { *; }
-keep class org.apache.logging.log4j.core.** { *; }

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