如何使用Java标准日志框架优雅记录系统运行轨迹与异常-java教程-PHP中文网

java标准日志框架jul开箱即用，需合理设置severe/warning/info/fine级别、使用类全限定名命名logger、完整记录异常堆栈与业务上下文，并定制formatter和filehandler以提升可读性与可维护性。

如何使用java标准日志框架优雅记录系统运行轨迹与异常

Java标准日志框架（java.util.logging，简称JUL）虽不如Log4j或SLF4J流行，但无需额外依赖、开箱即用，适合轻量级应用或对依赖敏感的场景。要“优雅”记录运行轨迹与异常，关键不在功能堆砌，而在日志级别合理、上下文清晰、格式统一、异常完整、可维护性强。

明确日志级别，让每条日志各司其职

JUL提供SEVERE、WARNING、INFO、CONFIG、FINE、FINER、FINEST七种级别。日常开发中聚焦前四种即可：

SEVERE：仅用于真正阻断流程的错误，如数据库连接彻底失败、核心配置加载异常；不要把业务校验失败（如“用户名已存在”）记为SEVERE
WARNING：潜在问题但系统仍可运行，如远程服务超时重试成功、缓存未命中率持续偏高
INFO：关键业务节点，如“订单创建成功，ID=ORD-20240517-8892”、“定时任务[order-cleanup]启动”
FINE及以上：仅调试启用，记录方法入参、SQL参数、中间状态等；生产环境默认关闭，避免性能损耗

用Logger命名规范建立可追溯的上下文

Logger名称应反映代码位置，推荐使用类全限定名：

正确写法：private static final Logger logger = Logger.getLogger(OrderService.class.getName());
避免硬编码字符串：Logger.getLogger("com.example.service.OrderService") —— 类名变更时易遗漏
不建议用包名（如Logger.getLogger("com.example.service")）—— 多个类日志混在一起，排查困难

这样在日志中自然带出类名，配合行号（需配置Formatter输出），能快速定位到具体方法和代码行。

记录异常时，别只打getMessage()，要留堆栈和上下文

捕获异常后，直接调用logger.severe(e.getMessage())会丢失堆栈，等于自废诊断能力：

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

✅ 正确方式：用重载方法传入Throwable，logger.severe("订单支付回调验证失败"); logger.severe("详细原因", e);
✅ 更推荐：一条语句完成，logger.log(Level.SEVERE, "订单支付回调验证失败", e);
⚠️ 注意：若需补充业务上下文（如用户ID、订单号），应拼接到日志消息中，而非仅靠异常对象 —— 异常本身不含这些信息

例如：logger.log(Level.WARNING, String.format("用户%s下单库存校验失败，商品ID=%s", userId, skuId), e);

定制Handler与Formatter，让日志真正可用

JUL默认控制台输出格式简陋、无时间戳、无线程名。生产环境至少需两项定制：

设置全局Formatter：继承SimpleFormatter或直接使用java.util.logging.SimpleFormatter，并通过系统属性启用时间戳：
System.setProperty("java.util.logging.SimpleFormatter.format", "%1$tY-%1$tm-%1$td %1$tH:%1$tM:%1$tS %4$s %2$s %5$s%6$s%n");
添加FileHandler并限制大小：避免日志无限增长
FileHandler fileHandler = new FileHandler("app-%g.log", 10_000_000, 5, true); // 5个10MB滚动文件
fileHandler.setFormatter(new SimpleFormatter());
logger.addHandler(fileHandler);
可选：禁用根Handler（ConsoleHandler），防止日志重复输出到控制台