Java日志五级需按场景精准使用：trace用于深度追踪，debug用于开发调试，info记录业务里程碑，warn标识非中断异常，error报告需人工介入的故障，须配堆栈和上下文。
Java 中正确使用 trace、debug、info、warn、error 五个核心日志级别，关键在于匹配场景、控制粒度、兼顾可读性与性能。不是“能打就打”，而是“该打才打、打对地方、打够信息”。
明确每个级别的语义和边界
五个级别不是随意排序，而是按信息重要性、影响范围和使用环境逐级递进：
- trace：最细粒度的执行路径追踪，比如方法进入/退出、循环内每次迭代变量值、SQL 绑定参数全过程。仅用于深度排查疑难问题，生产环境默认关闭。
- debug：开发调试用的关键中间状态，如服务调用前组装的请求体、缓存未命中时加载的原始数据、策略选择依据。测试环境开启，生产环境禁用。
- info：业务主干流程的“里程碑”事件，如用户登录成功、订单创建完成、定时任务开始执行。需包含可识别上下文（如 userId、orderId），且不泄露敏感信息。
- warn：非中断性异常情况，业务仍继续，但结果可能不符合预期。例如：第三方接口超时降级、配置项缺失使用默认值、数据库查不到关联数据但逻辑兜底正常。
- error：导致当前业务失败或系统功能受损的异常，必须有人介入。例如：数据库连接池耗尽、RPC 调用返回 500、空指针导致支付流程中断。务必附带完整异常堆栈。
避免常见误用陷阱
很多日志失效，源于级别错配或内容失当：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 把参数校验失败直接打 error——实际应分情况：必填字段为空打 error；可选字段格式不符且不影响后续处理，打 warn 更合适。
- 在 info 中打印整段 JSON 响应体——体积大、难检索，应只记录关键字段（如 status、code、bizId）和长度，必要时用 debug 输出全量。
- catch 块里只写 logger.error("操作失败")——丢失异常原因和上下文，应写成 logger.error("支付回调验签失败，orderNo={}", orderNo, e)。
- 用 System.out.println 或 printStackTrace 替代日志——绕过日志框架的异步、过滤、分级能力，生产环境严禁。
配合参数化与条件判断提升效率
日志输出本身有开销，尤其在高频路径上：
立即学习“Java免费学习笔记（深入）”；
- 优先使用参数化模板（如 logger.debug("user {} login from ip {}", userId, ip)），框架会延迟字符串拼接，避免无用对象创建。
- 对计算成本高的日志内容（如 JSON 序列化、集合 size() 循环统计），先判断级别是否启用：if (logger.isInfoEnabled()) { logger.info("stats: {}", expensiveCalc()); }。
- trace/debug 级别日志建议加 guard 判断，因为它们在生产环境通常关闭，避免无谓运算。
生产环境的日志策略要落地
级别设置不能只靠代码，更要靠配置和规范：
- logback.xml 或 log4j2.xml 中明确设置 root logger 级别（如 production 设为 info），并为不同包定制级别（如 com.xxx.service=info，org.apache.http=warn）。
- 禁止使用 ConsoleAppender，全部走异步 RollingFileAppender，防止 I/O 阻塞主线程。
- 敏感字段（密码、身份证号、银行卡号）必须脱敏后再打日志，info 及以上级别尤其注意。
- error 日志必须触发监控告警（如 ELK + Kibana + Alerting），warn 日志建议纳入定期巡检清单。
