TL;DR 演示如何通过 Log4j API 在运行时动态添加 KafkaAppender，实现无需重启的日志配置热更新，适用于线上排查和运维场景。

大多数 Java 开发者习惯通过配置文件（log4j.properties 或 log4j.xml）来管理日志输出。但在某些运维场景下，运行时动态修改日志配置会更加灵活——比如线上排查问题时临时开 DEBUG 级别，或者动态将日志推送到 Kafka 做集中分析。

Log4j 1.x 的 API 完全支持运行时代码修改配置。本文以 KafkaAppender 为例，演示如何动态添加 appender。

静态配置 vs 动态配置

方式	适用场景	优缺点
配置文件（静态）	日常开发、常规部署	简单、标准化；但修改需要重启
API 编程（动态）	线上排查、运维自动化	灵活，不需要重启；但需要对 API 熟悉

基本示例：动态添加 KafkaAppender

import org.apache.log4j.Logger;
import org.apache.log4j.PatternLayout;
import org.apache.log4j.Level;
import org.apache.log4j.net.SocketAppender; // 或其他

// 一个工具方法示例
public class Log4jConfigurator {
    
    public static void addKafkaAppender(String loggerName, String broker, 
                                          String topic, String layout) {
        Logger logger = Logger.getLogger(loggerName);
        
        KafkaLog4jAppender kafkaAppender = new KafkaLog4jAppender();
        kafkaAppender.setBrokerList(broker);
        kafkaAppender.setTopic(topic);
        kafkaAppender.setCompressionType("gzip");
        kafkaAppender.setSyncSend(false);
        kafkaAppender.setLayout(new PatternLayout(layout));
        kafkaAppender.activateOptions();
        
        logger.addAppender(kafkaAppender);
        logger.setLevel(Level.INFO);
    }
}

关键步骤：

创建 Appender 实例，设置目标地址、格式等参数
调用 activateOptions()——激活配置，很多 Appender 在这一步初始化连接
logger.addAppender() 添加到目标 Logger
设置日志级别——只有等于或高于该级别的日志才会被 Appender 处理

三个实战场景

场景一：线上临时开 DEBUG

线上出问题时，需要看到更详细的日志，但全局改 INFO 为 DEBUG 会产生海量日志。可以只对特定 Logger 动态调整：

// 只对 com.example.payment 这个包临时开 DEBUG
Logger paymentLogger = Logger.getLogger("com.example.payment");
paymentLogger.setLevel(Level.DEBUG);

// 排查完毕后恢复
paymentLogger.setLevel(Level.INFO);

配合一个 HTTP 端点暴露这个能力，就可以做到”浏览器点一下，DEBUG 就开了”。

场景二：动态路由日志到 Kafka

这是上面的主示例。适合需要实时日志分析的场景——把应用日志通过 Kafka 推到 ELK 或 Flink 等分析平台。

场景三：动态切换日志文件

// 从当前文件切换到新的滚动文件
Logger rootLogger = Logger.getRootLogger();
rootLogger.removeAllAppenders();

DailyRollingFileAppender newAppender = new DailyRollingFileAppender();
newAppender.setFile("/var/log/myapp/app.log");
newAppender.setDatePattern("'.'yyyy-MM-dd");
newAppender.setLayout(new PatternLayout("%d [%t] %-5p %c - %m%n"));
newAppender.activateOptions();

rootLogger.addAppender(newAppender);

注意事项

线程安全：Log4j 1.x 不是完全线程安全的。在多线程环境下动态修改配置，建议加同步锁或通过 JMX 管理
内存泄漏：动态添加的 Appender 记得在不需要时 removeAppender() 释放，特别是带有网络连接的 Appender（Kafka/Socket）
Log4j 2 更友好：Log4j 2 提供了原生的 Configurator API，线程安全且支持异步 Logger，是新项目更好的选择