log4j2高性能异步日志核心是启用asynclogger机制：必须引入log4j-core与disruptor（≥3.4.4）依赖，添加jvm参数-dlog4j2.contextselector=org.apache.logging.log4j.core.async.asyncloggercontextselector，禁用includelocation="true"，并合理配置disruptor缓冲区大小与等待策略。
Java 中配置 Log4j2 实现高性能异步日志记录，核心在于启用 AsyncLogger 机制，并配合合理的线程池与缓冲区设置，避免日志写入阻塞业务线程。Log4j2 的异步日志不是简单地用多线程打印，而是基于 LMAX Disruptor 高性能无锁环形队列实现的，性能远超同步或普通线程池封装方式。
启用 AsyncLogger（推荐方式）
Log4j2 提供两种异步模式：AsyncAppender（兼容旧版）和 AsyncLogger（更高效，推荐）。使用 AsyncLogger 需在配置中声明 <asynclogger></asynclogger> 或全局启用异步上下文。
- 在
log4j2.xml中，通过status="WARN"和monitorInterval="30"确保配置热加载和基础健康检查 - 设置系统属性
-Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector，让所有 Logger 自动变为异步（适用于大多数 Spring Boot 以外场景） - 若仅对部分模块异步，可显式定义：
<asynclogger name="com.example.service" level="info" includelocation="false"></asynclogger>
其中includeLocation="false"关键——关闭调用栈定位可显著提升性能（默认为 false，但显式声明更稳妥）
优化 Disruptor 配置参数
Disruptor 是异步日志的底层队列，其容量和等待策略直接影响吞吐与延迟。
- 通过 JVM 参数调整环形缓冲区大小：
-Dlog4j2.asyncLoggerRingBufferSize=262144（默认 256K，高并发场景建议设为 512K 或 1M） - 选择低开销等待策略：
-Dlog4j2.asyncLoggerWaitStrategy=TimeoutBlockingWaitStrategy（比默认的 Blocking 更快；若 CPU 密集可选YieldingWaitStrategy） - 避免日志事件堆积：当 RingBuffer 满时，默认丢弃新日志（
DiscardingAsyncQueueFullPolicy），如需保障不丢日志，可改用WaitStrategy并监控AsyncLogger.RingBufferFullJMX 指标
配置 Appender 与 Layout 的轻量化
异步再快，也扛不住低效的序列化或 I/O。Appender 和 Layout 必须精简。
- 禁用
%class、%method、%line等位置信息（已在 AsyncLogger 中设includeLocation="false"） - 使用
PatternLayout时避免复杂格式，例如不用%xEx全堆栈，而用%ex{short}或仅记录异常类型 - RollingFileAppender 启用
immediateFlush="false"和append="true"，并设置bufferedIO="true"（配合bufferSize="8192"）提升文件写入效率 - 考虑用
ConsoleAppender+AsyncAppender做开发环境快速输出，生产环境优先用异步 RollingFile
避免常见陷阱
异步日志看似开箱即用，但几个细节极易引发问题。
- 不要混用
AsyncLoggerContextSelector和手动包装AsyncAppender，会导致双重异步、资源浪费甚至死锁 - SLF4J 绑定必须使用
log4j-slf4j-impl（而非旧的slf4j-log4j12），否则 AsyncLogger 不生效 - 确保日志消息对象是不可变或只读的——异步线程可能在业务线程修改对象后才消费，导致数据错乱（尤其传入 Map、List 等）
- Spring Boot 2.4+ 默认使用 Log4j2，但需排除
spring-boot-starter-logging并引入spring-boot-starter-log4j2，且log4j2.xml放在resources下才能被识别
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
