Log4j2包级类级日志正则过滤技巧
本教程详细阐述了如何在Log4j2中配置复杂的日志过滤策略，以同时满足包级别和特定类级别的不同需求。通过结合Logger层级、RegexFilter和AppenderRef，文章展示了如何为整个包设置通用过滤规则，并为包内特定类应用独立且更精细的过滤条件，强调了AppenderRef的重要性及正则表达式语法的严谨性。
Log4j2日志过滤机制概览
在大型Java应用中，日志配置往往需要高度的灵活性，以满足不同模块或类的特定日志输出要求。Log4j2提供了强大的配置能力，通过其分层的Logger机制和各种Filter，可以实现非常精细的控制。核心概念包括：
- Logger层级（Logger Hierarchy）: Log4j2的Logger是分层的，例如com.app.package.one是com.app.package的子级，com.app.package.two.class7是com.app.package.two的子级。子级Logger会继承父级Logger的配置，但如果子级Logger有自己的显式配置，则其配置将优先应用。
- 过滤器（Filters）: Filter允许在日志事件被处理之前进行条件判断。RegexFilter是其中一种，它根据日志消息内容是否匹配正则表达式来决定是否接受或拒绝日志事件。
- Appender引用（AppenderRef）: Logger本身并不直接输出日志，它需要通过AppenderRef引用一个或多个Appender来将日志事件发送到实际的输出目的地（如控制台、文件等）。
复杂日志场景分析
假设我们面临以下日志需求：
- 通用规则: 应用程序所有类的日志级别都设置为ERROR。
- 通用内容过滤: 只有当日志消息中包含“exception”（不区分大小写）时，才打印日志。
- 特定类例外: 对于com.app.package.two.class7这个类，除了满足上述通用条件外，如果日志消息中包含“sometext”（不区分大小写），也需要打印。
这意味着com.app.package.two.class7需要比其父级包com.app.package更宽松的日志内容过滤条件。
初始配置尝试与问题诊断
最初的配置尝试可能如下所示，它试图通过定义两个Logger来解决问题：一个针对整个包，另一个针对特定类。
这段配置存在两个关键问题，导致其无法按预期工作：
- 缺少AppenderRef: 最重要的一个问题是，这两个Logger定义都没有包含
。这意味着即使日志事件匹配了Logger的级别和过滤器条件，它们也无法被发送到任何实际的输出目的地（如控制台或文件）。Log4j2的Logger必须显式地引用一个Appender才能输出日志。 - 正则表达式语法错误: 在针对class7的RegexFilter中，正则表达式.*(?i)exception(?-i).* | .*(?i)sometext(?-i).*在管道符|前后包含了空格。这些空格会被视为正则表达式的一部分，从而可能导致意外的匹配失败。正确的做法是紧凑地书写，即.*(?i)exception(?-i).*|.*(?i)sometext(?-i).*。
解决方案：正确的Log4j2配置
要同时满足所有条件，并确保日志能够正确输出，需要修正上述两个问题。以下是经过调整后的Log4j2 XML配置示例：
配置说明：
- Appenders 定义: 首先，我们定义了一个名为LogToConsole的ConsoleAppender。这是所有Logger将日志事件发送到的目的地。
- Logger name="com.app.package": 这个Logger配置应用于com.app.package包下的所有类，除非这些类有更具体的Logger定义。
- level="error": 设置日志级别为ERROR。
- RegexFilter: 只接受包含“exception”的日志消息。
- AppenderRef ref="LogToConsole": 将符合条件的日志事件发送到LogToConsole。
- additivity="false": 这是一个重要的属性。它表示此Logger的日志事件不会传递给其祖先Logger的Appender。将其设置为false可以避免重复日志输出，并确保每个Logger只通过其自身的AppenderRef进行输出。
- Logger name="com.app.package.two.class7": 这个Logger配置专门针对com.app.package.two.class7这个类。由于其名称比com.app.package更具体，Log4j2会优先应用此配置。
- level="error": 同样设置日志级别为ERROR。
- RegexFilter: 接受包含“exception”或“sometext”的日志消息。注意，这里的正则表达式.*(?i)exception(?-i).*|.*(?i)sometext(?-i).*已经修正，移除了管道符|两侧的空格，确保了正确的匹配行为。
- AppenderRef ref="LogToConsole": 将符合条件的日志事件发送到LogToConsole。
- additivity="false": 同样设置为false，以避免class7的日志事件向上冒泡到com.app.package的Logger并可能导致重复输出或不必要的处理。
- Root Logger: 根Logger是所有Logger的最终父级。它捕获所有未被特定
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
