如何使用log4j.properties为多用户分别生成独立日志文件

log4j本身支持通过MDC（Mapped Diagnostic Context，映射诊断上下文）实现动态变量注入，不需要动态修改log4j.properties文件本身，只需要提前配置占位符，业务代码中往MDC写入用户名即可实现按用户生成独立日志的需求，具体操作如下：

1. 编写log4j.properties配置 #

直接在配置中用${X:变量名}的格式定义占位符，后续从MDC读取对应值：

# 根日志基础配置
log4j.rootLogger=INFO,stdout,userLog

# 控制台输出配置（可选）
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p] [%c] - %m%n

# 动态用户日志文件输出配置
log4j.appender.userLog=org.apache.log4j.DailyRollingFileAppender
# 日志路径用${X:username}作为用户名占位符，后续从MDC读取
log4j.appender.userLog.File=/your/log/path/${X:username}.log
log4j.appender.userLog.DatePattern='.'yyyy-MM-dd
log4j.appender.userLog.layout=org.apache.log4j.PatternLayout
log4j.appender.userLog.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p] [%X{username}] - %m%n
log4j.appender.userLog.Append=true
log4j.appender.userLog.encoding=UTF-8

如果使用的是log4j2，配置逻辑一致，仅占位符格式调整为${ctx:username}即可。

2. 业务代码中注入用户名到MDC #

在API接口获取到用户名之后、业务逻辑执行之前，将用户名写入MDC：

import org.apache.log4j.MDC;

// 从API接口获取用户名
String username = getUsernameFromApi();
// 写入MDC，key和配置中的占位符保持一致
MDC.put("username", username);

请求处理完成后必须清除MDC，避免线程池复用导致的用户名错乱：

// 请求结束时调用
MDC.remove("username");

如果是Web项目，可以直接写一个全局拦截器/过滤器统一处理MDC的写入和清除，不需要每个接口单独实现。

注意事项 #

• 不建议通过动态修改log4j.properties文件的方式实现需求，配置文件修改会触发日志系统重载，会带来性能损耗、日志丢失的风险
• 如果需要跨线程传递MDC值，可以使用InheritableThreadLocal存储，或者手动将MDC参数传递给子线程
• 如果出现占位符不解析的情况，优先检查log4j版本，1.2.15及以上版本原生支持MDC变量解析

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