在log4j2中，当多个文件appender被配置为写入同一个日志文件，并同时关联到同一个logger（尤其是root logger）时，会导致日志事件被重复记录。解决此问题的核心在于确保每个文件appender都指定一个唯一的日志文件路径，从而实现日志内容的正确分流和记录，避免不必要的冗余。
Log4j2多Appender配置与日志重复写入问题解析
Log4j2作为一款高性能、灵活的日志框架，允许开发者通过配置多个Appender来将日志事件发送到不同的目的地，例如控制台、文件、数据库或远程服务器。然而，不当的配置，特别是涉及多个文件Appender时，可能导致日志内容重复写入的问题。本教程将深入探讨这一问题的原因及解决方案。
理解Log4j2的Appender与Logger机制
在Log4j2中，Logger负责接收应用程序生成的日志消息，并根据其级别和配置决定是否处理这些消息。Appender则负责将这些已处理的日志事件发送到具体的输出目标。一个Logger可以关联一个或多个Appender。当一个日志事件被Logger处理时，它会依次将该事件传递给所有关联的Appender。
问题重现：多Appender写入同一文件
当开发者希望将日志输出到不同的文件，但错误地配置了多个RollingFile Appender，并且这些Appender都指向了同一个fileName，同时又将它们全部关联到同一个Root Logger时，就会出现日志重复写入的问题。
考虑以下Log4j2配置示例：
在这个配置中，service1和service2两个RollingFile Appender都尝试将日志写入名为test.log的文件。当一个日志事件（例如 logger.info("Debugging data1");）被Root Logger接收时，它会首先传递给service1 Appender，service1会将该事件写入test.log。随后，同一个事件又会被传递给service2 Appender，service2也会将该事件写入test.log。结果就是，日志文件test.log中会包含每一条日志消息的两个副本，如下所示：
Debugging data1 Debugging data1 Debugging data2 Debugging data2
这种重复不仅浪费存储空间，还可能增加日志分析的复杂性。
解决方案：为每个文件Appender指定唯一文件
解决此问题的核心非常直观：确保每个旨在写入文件的Appender都拥有一个独一无二的fileName。这样，每个Appender就能将日志事件写入其各自的目标文件，从而避免冲突和重复。
修改后的Log4j2配置应如下所示：
通过将service1的fileName修改为test_service1.log，并将service2的fileName修改为test_service2.log，两个Appender现在将日志写入不同的文件。此时，Root Logger仍会将每个日志事件发送给service1和service2，但它们会分别记录到test_service1.log和test_service2.log中，各自文件中将不再出现重复的日志条目。
最佳实践与注意事项
Appender职责分离： 每个Appender都应该有明确的职责和目标。例如，一个Appender用于记录所有信息日志到通用文件，另一个用于记录错误日志到单独的错误文件，或者特定模块的日志到其专属文件。
文件命名策略： 采用清晰、有区分度的文件命名约定。可以使用服务名称、模块名称、日期等作为文件名的一部分，以便于识别和管理。
-
Logger层级与选择性Appender： 对于更精细的日志控制，可以利用Log4j2的Logger层级结构。例如，为特定包或类定义独立的Logger，并为其关联特定的Appender，而不是将所有Appender都挂载到Root Logger。
在上述配置中，com.example.service1的日志将只由service1 Appender处理，并且由于additivity="false"，这些日志不会传递给Root Logger及其关联的Appender。
性能考量： 尽管Log4j2在设计上考虑了并发写入，但多个Appender同时写入同一个文件可能会引入不必要的I/O竞争，尤其是在高并发场景下。为每个Appender分配独立的文件有助于优化I/O性能。
总结
Log4j2在处理日志输出方面提供了强大的灵活性，但正确的配置至关重要。当配置多个文件Appender时，务必确保每个Appender都指向一个唯一的日志文件路径，这是避免日志重复写入问题的根本解决方案。通过遵循Appender职责分离、合理命名文件以及利用Logger层级控制等最佳实践，可以构建一个高效、清晰且易于维护的日志系统。
