asynclogger + disruptor 通过无锁环形缓冲区实现高吞吐：日志线程仅轻量发布，消费者线程异步批量处理，复用事件对象减少gc；推荐全局异步配置并禁用includelocation，注意mdc捕获与应用关闭时的shutdown。
Log4j2 的异步日志（AsyncLogger）通过集成 LMAX Disruptor 高性能无锁环形缓冲区，显著降低日志写入的线程阻塞和对象创建开销，从而在高并发场景下实现远超同步日志和传统阻塞队列方案的吞吐量。
为什么 AsyncLogger + Disruptor 能大幅提效
传统同步日志直接调用 appenders，阻塞业务线程；而 AsyncLogger 将日志事件发布到 Disruptor 环形缓冲区，由独立消费者线程异步批量处理。Disruptor 采用无锁设计、缓存行填充、内存预分配等机制，避免了 volatile 写、CAS 重试和 GC 压力，单核吞吐可达百万级事件/秒。
- 日志记录线程只做轻量“发布”操作（指针移动），不等待落盘
- Disruptor 消费者线程串行执行格式化、序列化、IO，消除多线程竞争
- 日志事件对象复用（通过 RingBuffer 预分配 Event 对象），减少 GC
启用 AsyncLogger 的两种方式及关键配置
推荐使用全局异步（AsyncLoggerContextSelector），而非逐个声明 AsyncLogger —— 更简洁且覆盖所有 Logger。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 启动时添加 JVM 参数：
-Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector - 确保 classpath 中存在
disruptor-*.jar（Log4j2 2.17+ 已内置，旧版本需手动引入） - 配置文件中无需修改 Logger 定义，普通
<logger></logger>或 root logger 自动生效
若需局部控制，也可显式声明：<asynclogger name="com.example" level="info" includelocation="false"></asynclogger>，但注意 includeLocation="true" 会触发栈遍历，严重拖慢性能，生产环境应禁用。
调优 Disruptor 缓冲区与线程行为
默认 RingBuffer 大小为 214 = 16384，适用于多数场景；高吞吐服务可适当增大（如 216=65536），但需权衡内存占用与延迟。
- 通过系统属性设置大小：
-Dlog4j2.asyncLoggerRingBufferSize=65536 - Disruptor 默认使用守护线程消费，不可配置线程名；如需监控，可通过 JMX 查看
AsyncLoggerRingBufferMBean - 当 RingBuffer 满时，默认策略是丢弃新日志（
BlockingWaitStrategy会阻塞，不推荐），可设-Dlog4j2.asyncLoggerWaitStrategy=TimeoutBlockingWaitStrategy控制超时行为
注意事项与常见陷阱
AsyncLogger 不是万能银弹，需规避其限制才能稳定发挥性能优势。
- 不能保证日志顺序严格一致：同一 Logger 的日志仍保序，但跨 Logger 或混用同步/异步 Logger 时可能乱序
-
异常堆栈和上下文信息需提前捕获：如 MDC、NDC 在异步线程中不可见，应在记录前
MDC.getCopy()并显式传入 -
慎用
Logger.debug(() -> expensiveOperation())：Lambda 延迟求值在异步线程执行，可能导致非预期副作用或 NPE - 应用关闭时需显式调用
LogManager.shutdown()，确保 RingBuffer 中剩余日志被消费完毕
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
