java多租户/模块日志隔离需通过mdc+自定义appender、siftingappender或模块专属logger实现：前者利用mdc传入租户id并动态路由文件路径；siftingappender自动按mdc键分流并复用子appender；后者为各模块绑定独立appender。须注意mdc跨线程传递、敏感信息泄露、文件管理及log4j2差异。
Java 中实现多租户或多模块的日志隔离，核心是让不同租户或模块的日志写入各自独立的文件，而不是混在一起。这不能靠日志框架默认配置完成，需要结合 MDC（Mapped Diagnostic Context）、自定义 Appender、动态日志器（Logger）管理，以及合理的命名与路由策略。
利用 MDC + 自定义 Appender 实现动态文件路由
MDC 是 SLF4J 提供的线程级上下文存储机制，适合在请求入口（如 Web Filter 或 Spring Interceptor）中注入租户 ID 或模块标识，再由日志 Appender 读取该值决定输出路径。
- 在请求开始时（例如 Filter 的 doFilter 方法），调用 MDC.put("tenantId", tenantId) 或 MDC.put("module", "payment")
- 编写继承自 RollingFileAppender（Logback）或 FileAppender（Log4j2）的自定义 Appender，在 subAppend 或 append 方法中从 MDC 获取 key，拼接出对应文件路径（如 logs/tenant_A/app.log）
- 注意文件句柄管理和滚动策略：避免为每个租户创建过多独立 RollingFileAppender 实例，推荐复用单个 Appender，仅动态切换 fileNamePattern 或 file 属性（Logback 可通过 FileNamePattern 支持变量，但需配合 SiftingAppender）
使用 SiftingAppender（Logback）按租户自动分流
Logback 内置的 SiftingAppender 是专为这类场景设计的：它根据 MDC 中某个 key 的值，动态创建并复用子 Appender（通常是 RollingFileAppender），每个 key 值对应一个独立日志文件。
- 在 logback.xml 中配置：
- 设置
tenantId 指定从 MDC 读取哪个字段 - 在
子节点中定义 RollingFileAppender，其 file 和 fileNamePattern 可使用 %X{tenantId} 占位符（如 logs/$${contextName:-default}/%X{tenantId}/app.log） - 注意：SiftingAppender 会缓存子 Appender，长期运行下需配置
100 防止内存泄漏
按模块划分 Logger 实例 + 独立 Appender 绑定
对模块化边界清晰的系统（如订单、支付、用户服务），可不依赖 MDC，直接为每个模块声明专属 Logger，并绑定专属 Appender。适用于启动时模块已知、无需运行时动态增删的场景。
- 定义多个 RollingFileAppender，分别命名为 ORDER_APPENDER、PAYMENT_APPENDER，各自配置不同 file 路径和 rollingPolicy
- 在代码中获取模块专用 Logger：LoggerFactory.getLogger("com.example.order")，并在 logback.xml 中用
- 优势是简单稳定、无 MDC 清理风险；缺点是无法支持同一模块内多租户细分，且模块增多时配置易冗余
注意事项与避坑点
实际落地时，几个关键细节容易引发问题：
- MDC 不自动跨线程传递：异步操作（如 CompletableFuture、线程池任务）需手动 MDC.getCopyOfContextMap() 保存并在子线程 MDC.setContextMap() 还原
- 租户 ID 泄露风险：确保 MDC 中敏感字段（如真实 tenantId）不在日志模板中意外打印，建议日志 pattern 中只用 %X{tenantId} 输出，不暴露原始上下文
- 文件权限与磁盘空间：大量租户会导致海量小文件，建议按租户分目录 + 合理滚动策略（如按天+大小双策略），并增加定时清理脚本
- Log4j2 用户注意：Log4j2 对应方案是 RoutingAppender + ContextSelector，逻辑类似，但配置语法和变量写法（$${ctx:tenantId}）不同
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
