选对日志级别本质是平衡可观测性与系统开销:debug为开发者调试用的细节显微镜,线上默认关闭;info是生产环境主力级别,记录有业务语义的关键运行状态;warn标识需人工检查的黄灯异常;error代表需立即处理的红灯故障;fatal仅用于进程级灾难。

选对日志级别,本质是平衡“可观测性”和“系统开销”——既要让问题可查、可定位,又不能淹没关键信号或拖慢性能。核心不是记多少,而是每条日志该在什么场景下、以什么身份出现。
Debug:只给开发者看的“显微镜”
它记录的是开发调试时才需要的细节,比如方法入参值、循环中间状态、缓存命中与否、HTTP 请求头原始内容等。线上环境默认关闭,不参与生产监控。
- 适合:本地调试、预发验证、临时加点排查逻辑分支
- 注意:必须用 if 判断包裹(如 if (log.isDebugEnabled()) { log.debug("..."); }),避免字符串拼接开销
- 别写:用户行为摘要、接口耗时统计、成功/失败标识——这些属于 INFO 或 WARN
Info:面向运维和业务方的“运行快报”
INFO 是生产环境默认开启的主力级别,描述系统“按预期运转”的关键节点。它不是流水账,而是有业务语义的状态快照。
- 适合:服务启动完成、定时任务开始/结束、外部接口首次调用成功、关键配置加载完成、用户登录/登出(脱敏后)
- 注意:参数要脱敏(如手机号打星)、避免高频刷屏(如每秒一条请求日志需降级为 DEBUG)
- 别写:异常堆栈、空指针警告、SQL 执行超时——这些已超出“正常运行”范畴
Warn:系统发出的“黄灯提醒”
Warn 表示当前没崩,但已偏离健康轨道,后续可能引发问题。它不中断流程,但值得人工介入检查。
- 适合:第三方服务响应超时(启用降级)、配置项缺失使用默认值、数据库连接池使用率持续 >90%、用户传了非法但可忽略的字段
- 注意:必须带上下文,例如 log.warn("支付回调验签失败,订单号={},原因=签名格式错误", orderId)
- 别写:已捕获并兜底处理的可预期异常(如 Redis 连接失败后自动切到本地缓存)——若完全无影响,甚至可不记
Error:需要立即关注的“红灯故障”
Error 意味着目标操作明确失败,且无法通过当前逻辑自愈。它通常伴随异常对象,是监控告警的主要触发源。
- 适合:数据库主键冲突、RPC 调用返回明确业务错误码、文件写入磁盘失败、解析 JSON 严重格式错误
- 注意:必须打印完整异常(log.error("下单失败", e)),不能只打消息;同一异常不要重复记多条 Error
- 别写:try-catch 后吞掉异常只打 info;或把 warn 场景强行升级成 error(如某次重试失败但还有下次)
Fatal:系统已不可信,准备收摊
Fatal 在现代 Java 应用中极少使用。它代表进程级灾难,比如 JVM 内存彻底耗尽、核心线程池被意外 shutdown、安全密钥加载失败且无备用方案。
- 适合:JVM OOM 后的最后自救日志、关键守护线程退出、加密模块初始化失败导致全链路不可用
- 注意:记完通常应主动调用 System.exit() 或触发容器重启;日常业务代码基本不需要
- 别写:数据库查询为空、用户输入参数校验不通过、HTTP 404 —— 这些都是正常业务分支
实际项目里,绝大多数日志落在 INFO 和 ERROR 两级;WARN 是最有价值的“灰度信号”,而 DEBUG 是开发者的私有工具。记住:日志不是越多越好,而是每一条都该回答一个问题——“谁、在什么时间、做了什么、结果如何、为什么这样”。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











