log4j日志配置有哪些注意事项，log4j怎么配置

log4j日志配置核心要点

日志系统是应用程序的“眼睛”，Log4j 2.x 相比 1.x 在性能上提升巨大（异步日志吞吐量提升 10 倍以上），建议新项目直接采用 Log4j 2.17.x 及以上版本（规避安全漏洞），配置核心三要素：Logger（日志级别声明）、Appender（输出目标）、Layout（输出格式）,下面从基础配置到生产级优化逐一展开。

基础配置结构与参数详解

一个完整的 log4j2.xml 必须包含 <Appenders> 与 <Loggers> 两个顶级节点，以下是最常用的 Console + RollingFile 组合配置：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" monitorInterval="30">
    <Properties>
        <Property name="LOG_PATTERN">%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level [%t] %c{1.} - %msg%n</Property>
        <Property name="LOG_HOME">/data/logs/app</Property>
    </Properties>
    <Appenders>
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="${LOG_PATTERN}"/>
        </Console>
        <RollingFile name="RollingFile"
                     fileName="${LOG_HOME}/app.log"
                     filePattern="${LOG_HOME}/app.%d{yyyy-MM-dd}-%i.log.gz">
            <PatternLayout pattern="${LOG_PATTERN}"/>
            <Policies>
                <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
            <DefaultRolloverStrategy max="30"/>
        </RollingFile>
    &l
t;/Appenders>
    <Loggers>
        <AsyncLogger name="com.example" level="DEBUG" additivity="false">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile"/>
        </AsyncLogger>
        <Root level="INFO">
            <AppenderRef ref="Console"/>
        </Root>
    </Loggers>
</Configuration>

关键参数解读：

• monitorInterval="30"：每 30 秒扫描配置文件，支持热更新，无需重启应用
• additivity="false"：避免日志在多 Logger 链路中重复打印
• filePattern 中的 %i：配合 SizeBasedTriggeringPolicy，实现按大小切分后的序号命名

进阶调优：异步日志与性能提升

同步日志在高并发下存在严重的线程阻塞瓶颈，生产环境务必开启异步日志，Log4j2 提供了两种异步实现方式：

全异步模式

在系统属性中设置,或直接在配置文件中加入：

<AsyncRoot level="INFO">
    <AppenderRef ref="RollingFile"/>
</AsyncRoot>

混合异步模式（推荐）

<AsyncLogger name="com.example.order" level="INFO" additivity="false">
    <AppenderRef ref="RollingFile"/>
</AsyncLogger>

经验案例（酷番云线上实践）：

在酷番云服务器上部署 Spring Boot 订单服务时，起初使用同步日志，高峰期线程池被日志 I/O 拖累，P99 延迟从 80ms 飙升至 500ms，切换为混合异步模式后，将

AsyncLogger 的 RingBuffer 大小调至 65536（默认 8192），配合 waitStrategy 设置为 Block，P99 稳定在 95ms 以内。修改方式为在启动脚本中追加 -Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector，无需改动 XML 配置即可全局启用。

生产环境必备配置策略

生产环境日志配置需关注以下三大问题：格式可读性、文件滚动策略、敏感信息脱敏。

结构化日志（JSON 格式）

面向微服务和日志采集场景，建议输出 JSON 格式，便于接入 ELK 或云日志服务：

<JsonLayout complete="false" compact="true" properties="true">
    <KeyValuePair key="traceId" value="$${ctx:traceId}"/>
</JsonLayout>

日志文件滚动策略

• 按时间 + 大小双重触发，避免单一维度导致的隐患
• 保留策略：max="30" 保留最近 30 个文件，结合 %d{yyyy-MM-dd} 实现按天归档
• 压缩策略：使用 .gz 后缀，减少磁盘占用约 80%

敏感信息过滤

Log4j2 支持通过 RegexFilter 实现脱敏：

<RegexFilter regex="(password|token)=[^&]" replace="$1="/>

常见坑点排查与解决方案

Log4j 1.x 与 2.x API 混用

项目同时引入 log4j-over-slf4j 和 log4j-slf4j-impl 会导致 ClassNotFoundException 或日志丢失。解决方案：统一使用 SLF4J 门面 + Log4j2 适配器，仅保留一个桥接包。

异步日志应用启动即报错

排查顺序：

• 确认 disruptor 依赖已显式引入
• 检查线程工厂是否自定义、队列是否填满导致拒绝策略触发

日志无法按天切割

• 检查 filePattern 中是否包含时间戳
• 确认 TimeBasedTriggeringPolicy 的 interval 与 filePattern 粒度一致

相关问答模块

Q1：log4j2 配置了 RollingFile 但文件不滚动，是什么原因？

答： 最常见的原因是 filePattern 中的时间粒度与 TimeBasedTriggeringPolicy 的 interval 不匹配，或者应用运行时间未超过滚动周期，如果你设置 interval="1" 表示按天滚动，但 filePattern 只精确到小时，文件永远不会按天切分。建议做法是：filePattern 的时间粒度必须小于或等于触发策略的粒度，filePattern="app.%d{yyyy-MM-dd}.log" 配合 interval="1"（天），若希望每小时切分则使用 %d{yyyy-MM-dd-HH} 并设置 interval="1" 配合 modulate="true"。

Q2：生产环境如何快速定位并清理重复日志？

答： 重复日志的产生通常是多个 Logger 继承了 Root Logger，且 additivity 未设为 false。排查步骤：在日志中观察相同的消息是否同时输出到多个 Appender；其次检查父子 Logger 的 AppenderRef 是否重复。解决思路：业务包使用独立的 Logger 并显式设置 additivity="false"，让 Root 只兜底未配置的包；对于无法改代码的场景，可以通过全局搜索 <Logger name= 配置，将重复引用的 Appender 移除。