Logback 系列(13):生产环境配置建议清单
本系列第 13 篇。把前面的经验浓缩成一份可直接对照的 checklist。
配置 checklist
- ✅ 用
logback-spring.xml,配合<springProfile>按环境切换。 - ✅ 生产日志级别 INFO 起步,别开 DEBUG(量大、泄漏信息、拖慢性能)。
- ✅ 文件必须用 RollingFileAppender ,配
MaxHistory+totalSizeCap防磁盘打满。 - ✅ 高并发用 AsyncAppender,明确好丢弃策略。
- ✅ 接平台输出 JSON,带上 traceId/level/logger 便于检索。
- ✅ 日志发送(Kafka/网络)配 短超时 + 不重试,绝不阻塞业务。
- ✅ 屏蔽第三方框架的噪音日志(如 Kafka 客户端、Hibernate SQL)。
- ✅ 对超长日志做 截断 (
%.-Nmsg),防止爆盘。 - ⚠️ 敏感信息(密码、token、身份证)不要打日志。配置里的密码建议改为从环境变量/密钥管理注入。
- ✅ ERROR 级别可接告警(自定义 Appender → 钉钉/企微)。
分环境级别建议
| 环境 | 根级别 | 说明 |
|---|---|---|
| dev | DEBUG / INFO | 方便调试 |
| test/sit | INFO | 接近生产 |
| prod | INFO | 只留必要信息,WARN/ERROR 重点关注 |
性能相关
- 大对象、集合别整个
toString打日志。 - 高频路径避免打 INFO,改 DEBUG 并在生产关闭。
includeCallerData非必要别开(获取行号很慢)。
上一篇:MDC 链路追踪
下一篇:常见坑与排查