Java日志系统需严格区分ERROR、WARN、INFO、DEBUG级别：ERROR表系统级异常并触发告警；WARN表潜在风险可配低优先级告警；INFO记录关键业务节点；DEBUG仅开发期启用且生产关闭；须配合框架配置分级输出、MDC增强与告警闭环。
Java 日志系统中，通过日志级别（Level）区分关键错误和常规业务输出，核心在于合理使用 ERROR、WARN、INFO、DEBUG 等标准级别，并配合日志框架（如 Logback、Log4j2）的配置实现分级路由与告警触发。
明确各级别的语义边界
日志级别不是随意打标，而是有明确业务含义的信号：
- ERROR：系统级异常，服务不可用、数据严重损坏、外部依赖完全失效（如数据库连接池耗尽、核心 RPC 全量超时）；必须触发告警
- WARN：潜在风险，非阻断但需关注（如降级开关开启、HTTP 5xx 响应率突增、缓存命中率跌破阈值）；可配置为低优先级告警
- INFO：关键业务流转节点（如“订单创建成功”、“支付回调接收”），不含敏感数据，用于追踪主流程
- DEBUG：仅开发/排查期启用，含参数、SQL、上下文快照；生产环境默认关闭
在代码中精准打点，避免级别滥用
不要用 INFO 记录异常堆栈，也不要用 ERROR 打印用户输入校验失败——这类属于正常业务分支，应走 INFO 或 WARN：
- 捕获异常后，若已兜底（如返回默认值、走备用链路），记录 WARN + 关键上下文（traceId、method、errorCode）
- 未捕获的 RuntimeException / Error 必须由全局异常处理器统一记为 ERROR，并附带完整 stackTrace
- 使用 SLF4J 的占位符写法：
log.warn("库存扣减失败，商品:{}，剩余:{}，原因:{}", skuId, left, reason);避免字符串拼接影响性能
通过日志框架配置实现物理分离
以 Logback 为例，利用 <filter> 和 <appender-ref> 将不同级别路由到不同目标：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
立即学习“Java免费学习笔记（深入）”；
- ERROR 单独输出到
error.log，并绑定邮件/企微机器人告警（通过SMTPAppender或自定义SocketAppender） - WARN 输出到
warn.log，接入 Prometheus + Grafana 监控告警（用 FileWatcher 抽取行数或关键词） - INFO 及以下写入
app.log，供 ELK 或 Loki 查询，设置滚动策略（按天+大小限制） - 禁止将 ERROR 写入 INFO 日志文件——避免告警被淹没
结合 MDC 实现上下文增强与动态过滤
在入口处（如 Spring MVC 拦截器）注入 traceId、userId、bizType 到 MDC，再配合日志 Pattern 和自定义 Filter 提升告警精度：
- 对特定业务类型（如
bizType=pay）的 ERROR 自动升级为 P0 告警 - 对高频 WARN（如每分钟超 10 次的“库存预扣失败”）做聚合去重，避免告警风暴
- 在 logback.xml 中用
<TurboFilter>拦截含敏感字段（如 idCard、phone）的日志，直接丢弃或脱敏
不复杂但容易忽略的是：级别本身不产生价值，真正起作用的是人对级别的共识 + 配置的强制约束 + 告警通道的响应闭环。定期 Review ERROR 日志 Top N 堆栈，反向优化代码健壮性，比调高告警阈值更治本。
