1. 项目概述被低估的“原住民”日志工具聊到Java日志大家脑子里蹦出来的多半是Log4j 2、Logback再配上SLF4J这个门面这几乎成了现代Java项目的标准答案。但很多开发者尤其是刚入行的朋友可能都忽略了一个事实Java自己就带了一套完整的日志系统——java.util.logging简称JUL。它从JDK 1.4时代就默默存在是JDK的“原住民”。我见过不少项目为了一个简单的日志功能二话不说就引入一堆第三方依赖却对自带的工具视而不见。这有点像家里明明有把好用的瑞士军刀却非要出门买一套专业工具来处理日常小问题。java.util.logging.Logger就是这个“瑞士军刀”的核心。它提供了一套从日志记录、级别过滤、格式化输出到日志分发的完整框架。对于不需要复杂日志切面、分布式追踪的中小型应用、工具类项目或者一些对依赖数量极其敏感比如某些嵌入式环境或要求极简打包的场景的情况JUL完全够用甚至能让你省去不少依赖管理的麻烦。理解它不仅能让你在技术选型时多一个轻量级选项更能帮助你深入理解日志框架的通用模型因为很多设计理念在各类日志框架中是相通的。接下来我们就抛开对“自带工具”的偏见深入拆解一下这个熟悉又陌生的老朋友。2. JUL核心架构与组件解析要玩转JUL首先得摸清它的家底。它的架构清晰核心组件各司其职理解它们之间的关系是灵活配置和使用的关键。2.1 核心组件职责与协作关系JUL的日志流水线主要由以下几个核心部件串联而成Logger日志记录器这是开发者打交道最多的对象。我们通过Logger.getLogger(String name)来获取或创建Logger实例。它的名字通常使用类的全限定名这形成了层次化的命名空间例如“com.example.service”是“com.example”的子级便于继承配置。LogRecord日志记录这是一个承载单条日志所有信息的纯数据对象包括日志级别、消息、时间戳、源类/方法名、线程ID等。Logger负责创建LogRecord并传递给后续处理器。Handler处理器负责将LogRecord输出到具体的目的地。JUL内置了多种HandlerConsoleHandler: 输出到系统错误流System.err。FileHandler: 输出到文件支持文件滚动、大小限制等策略。SocketHandler: 通过网络套接字发送日志。MemoryHandler: 在内存缓冲区中缓存一定数量的LogRecord。Formatter格式化器附着在Handler上负责将一个LogRecord对象格式化成人类可读或机器可读的字符串。内置的有SimpleFormatter简单文本格式和XMLFormatterXML格式。Filter过滤器可以附加在Logger或Handler上提供比日志级别更细粒度的控制决定某条LogRecord是否应该被记录或输出。Level日志级别定义了日志的严重程度。从高到低依次为SEVERE,WARNING,INFO,CONFIG,FINE,FINER,FINEST。另外还有OFF关闭所有和ALL开启所有。工作流程大致是应用程序调用Logger.log(Level, String)- Logger创建LogRecord - Logger应用自身Level和Filter检查 - 将有效的LogRecord传递给其所有Handler及父Logger的Handler - 每个Handler应用自己的Level、Filter和Formatter - 输出到目标控制台、文件等。2.2 层次化Logger树与配置继承这是JUL设计中一个非常巧妙且重要的特性。Logger通过点号.分隔的名称形成了树状结构。例如名为“com.example”的Logger是“com.example.service”和“com.example.dao”的父Logger。这种层次化带来了配置的继承性级别继承如果子Logger没有设置自己的级别它将继承父Logger的级别。这允许你在根节点名为空字符串的Logger设置一个全局级别然后在特定包下设置更详细或更严格的级别。Handler继承默认情况下日志消息会向上传递给父Logger的Handler除非将Logger的useParentHandlers属性设为false。这意味着你可以在根Logger添加一个FileHandler用于全局日志归档同时在某个子Logger添加一个ConsoleHandler用于调试特定模块两者互不干扰又能协同工作。理解这个树形结构是进行精细化日志管理的基础。很多配置混乱的问题都源于没有理清Logger之间的父子关系和Handler的传递路径。注意根LoggerLogger.getLogger()是一个特殊的存在它位于Logger树的顶端。通常全局性的Handler如写入日志文件的FileHandler会附加在它上面。直接获取根Logger进行操作时需要小心以免影响整个应用的日志行为。3. 从零开始基础使用与配置实战理论说再多不如动手试一下。我们抛开任何IDE的魔法从最原始的方式开始一步步感受JUL的能力。3.1 代码中的基本日志记录使用JUL记录日志非常简单无需任何额外依赖。import java.util.logging.Logger; import java.util.logging.Level; public class JulDemo { // 获取一个Logger实例通常以当前类名命名 private static final Logger LOGGER Logger.getLogger(JulDemo.class.getName()); public static void main(String[] args) { // 记录不同级别的日志 LOGGER.severe(这是一个严重错误信息级别最高。); LOGGER.warning(这是一个警告信息表示潜在问题。); LOGGER.info(这是一个普通信息常用于记录程序运行状态。); // 使用log方法可以更灵活地指定级别和参数 LOGGER.log(Level.INFO, 用户 {0} 在 {1} 登录成功。, new Object[]{张三, 2023-10-27}); // 记录异常堆栈信息这是非常常用的功能 try { int result 10 / 0; } catch (Exception e) { LOGGER.log(Level.SEVERE, 计算过程中发生除零错误, e); } // 更细粒度的调试日志默认不输出需要调整级别 LOGGER.fine(这是一条FINE级别的调试信息。); LOGGER.finest(这是一条FINEST级别的超详细跟踪信息。); } }直接运行这段代码你会发现只有SEVERE、WARNING、INFO级别的日志输出到了控制台而FINE和FINEST级别的信息不见了。这是因为JUL的根Logger默认级别是INFO低于此级别的日志会被过滤掉。输出格式是JUL默认的SimpleFormatter样式包含了日期、类名、方法名和日志信息。3.2 编程式配置动态控制日志行为除了在代码中硬编码我们更常用编程方式或配置文件来动态调整日志行为。先看编程式配置import java.util.logging.*; public class ProgrammaticConfig { private static final Logger LOGGER Logger.getLogger(ProgrammaticConfig.class.getName()); public static void main(String[] args) throws Exception { // 1. 关闭默认的ConsoleHandler避免重复输出 Logger rootLogger Logger.getLogger(); for (Handler handler : rootLogger.getHandlers()) { rootLogger.removeHandler(handler); } // 2. 创建并配置一个FileHandler // 参数模式%t表示系统临时目录文件大小限制字节备份文件数是否追加 FileHandler fileHandler new FileHandler(%t/myapp-%u-%g.log, 1024 * 1024, 10, true); fileHandler.setFormatter(new SimpleFormatter()); fileHandler.setLevel(Level.ALL); // Handler自身级别决定处理哪些级别的记录 // 3. 创建并配置一个ConsoleHandler使用自定义格式 ConsoleHandler consoleHandler new ConsoleHandler(); consoleHandler.setFormatter(new Formatter() { Override public String format(LogRecord record) { return String.format([%1$tT] [%2$-7s] %3$s %n, new java.util.Date(record.getMillis()), record.getLevel(), record.getMessage()); } }); consoleHandler.setLevel(Level.WARNING); // 控制台只输出WARNING及以上级别 // 4. 将Handler添加到根Logger影响所有Logger rootLogger.addHandler(fileHandler); rootLogger.addHandler(consoleHandler); rootLogger.setLevel(Level.FINE); // 设置根Logger级别决定产生哪些LogRecord // 5. 设置我们自己的Logger级别覆盖继承的级别 LOGGER.setLevel(Level.FINEST); LOGGER.setUseParentHandlers(true); // 依然使用父Logger的Handler // 测试输出 LOGGER.severe(严重错误 - 会同时输出到文件和控制台); LOGGER.warning(警告 - 会同时输出到文件和控制台); LOGGER.info(信息 - 只输出到文件控制台Handler级别是WARNING); LOGGER.fine(调试信息 - 只输出到文件); LOGGER.finest(跟踪信息 - 只输出到文件); } }这段代码演示了几个关键点移除默认Handler避免与自定义配置冲突。Handler级别 vs Logger级别Logger级别决定是否创建LogRecordHandler级别决定是否处理接收到的LogRecord。两者是“与”的关系。自定义Formatter可以完全控制输出格式满足特定需求如JSON格式。文件滚动FileHandler的模式字符串%t/myapp-%u-%g.log中%u是唯一编号%g是代编号配合文件大小和备份数实现了日志滚动。3.3 配置文件详解生产环境的标准做法对于生产环境将配置外置到文件中是最佳实践。JUL默认会从$JAVA_HOME/jre/lib/logging.properties加载全局配置但我们更推荐在应用启动时指定自己的配置文件。首先创建一个my-logging.properties文件# 指定根Logger的级别和使用的Handler .levelINFO handlersjava.util.logging.ConsoleHandler, java.util.logging.FileHandler # 控制台Handler的配置 java.util.logging.ConsoleHandler.levelINFO java.util.logging.ConsoleHandler.formatterjava.util.logging.SimpleFormatter # 可以覆盖SimpleFormatter的默认格式 java.util.logging.SimpleFormatter.format[%1$tF %1$tT] [%4$-7s] %5$s %n # 文件Handler的配置 java.util.logging.FileHandler.levelALL java.util.logging.FileHandler.formatterjava.util.logging.SimpleFormatter java.util.logging.FileHandler.pattern%t/myapp.log java.util.logging.FileHandler.limit10485760 # 10MB java.util.logging.FileHandler.count5 java.util.logging.FileHandler.appendtrue # 为特定包或类设置更详细的日志级别 com.example.service.levelFINE com.example.dao.levelWARNING然后在启动应用时通过系统属性指定该配置文件java -Djava.util.logging.config.file/path/to/my-logging.properties -jar myapp.jar或者在程序启动的最开始在任何Logger被初始化之前动态加载public class LoadConfigFile { public static void main(String[] args) throws Exception { try (InputStream ins LoadConfigFile.class.getResourceAsStream(/my-logging.properties)) { LogManager.getLogManager().readConfiguration(ins); } // ... 后续代码 } }使用配置文件的好处是无需修改代码即可调整日志行为非常适合运维和调试。配置文件中的格式字符串format遵循java.util.Formatter语法%1$代表第一个参数LogRecord%1$tF和%1$tT分别代表格式化的日期和时间%4$s代表Logger名称%5$s代表日志消息。4. 高级特性与自定义扩展掌握了基础我们来看看JUL那些不常被提及但能解决特定痛点的高级能力。4.1 实现自定义Filter进行精细化过滤有时候仅靠日志级别不够。比如我们想记录所有来自特定用户ID或包含特定关键词的INFO日志。这时就需要自定义Filter。import java.util.logging.*; public class UserIdFilter implements Filter { private final String targetUserId; public UserIdFilter(String targetUserId) { this.targetUserId targetUserId; } Override public boolean isLoggable(LogRecord record) { // 假设我们将用户ID放在参数里或者通过消息解析 Object[] parameters record.getParameters(); if (parameters ! null parameters.length 0) { // 这里简单判断第一个参数是否包含目标用户ID if (parameters[0].toString().contains(targetUserId)) { return true; } } // 也可以检查消息体 if (record.getMessage().contains(targetUserId)) { return true; } // 不匹配则过滤掉 return false; } } // 使用方式 Logger logger Logger.getLogger(com.example.service); logger.setFilter(new UserIdFilter(USER_12345)); logger.setLevel(Level.INFO); // 只有包含USER_12345的INFO及以上日志才会被记录 logger.info(User USER_12345 performed action A.); logger.info(User USER_99999 performed action B.); // 这条将被过滤掉Filter可以同时附加在Logger和Handler上提供了两层过滤机制非常灵活。4.2 开发自定义Formatter输出结构化日志现代日志分析平台如ELK、Splunk更青睐结构化数据如JSON。JUL默认的Formatter不满足需求我们可以自己实现一个。import java.util.logging.*; import com.google.gson.Gson; // 假设使用Gson库需要额外依赖 public class JsonFormatter extends Formatter { private static final Gson GSON new Gson(); Override public String format(LogRecord record) { MapString, Object logEvent new LinkedHashMap(); logEvent.put(timestamp, record.getMillis()); logEvent.put(level, record.getLevel().getName()); logEvent.put(logger, record.getLoggerName()); logEvent.put(thread, record.getThreadID()); logEvent.put(message, record.getMessage()); if (record.getParameters() ! null) { logEvent.put(parameters, record.getParameters()); } if (record.getThrown() ! null) { MapString, Object exception new HashMap(); exception.put(type, record.getThrown().getClass().getName()); exception.put(message, record.getThrown().getMessage()); // 可以进一步处理堆栈信息 exception.put(stackTrace, Arrays.stream(record.getThrown().getStackTrace()) .map(StackTraceElement::toString) .collect(Collectors.toList())); logEvent.put(exception, exception); } logEvent.put(sourceClass, record.getSourceClassName()); logEvent.put(sourceMethod, record.getSourceMethodName()); return GSON.toJson(logEvent) System.lineSeparator(); // 每条日志为一行JSON } } // 配置Handler使用此Formatter FileHandler handler new FileHandler(app.json.log); handler.setFormatter(new JsonFormatter());这样日志文件就变成了每行一个JSON对象非常适合用Filebeat等工具直接采集并导入Elasticsearch进行分析。注意自定义Formatter中如果使用了第三方库如Gson需要确保该类能被JUL的类加载器访问到在生产环境中部署时需要打包相应依赖。4.3 使用MemoryHandler实现日志缓冲与异步化雏形JUL默认是同步输出日志的这可能在极端高并发下对性能有影响。虽然JUL本身没有提供完整的异步Handler但MemoryHandler提供了一种缓冲机制可以看作一种轻量级的异步化方案。// 首先需要一个目标Handler比如FileHandler FileHandler targetHandler new FileHandler(app.log); targetHandler.setFormatter(new SimpleFormatter()); // 创建MemoryHandler设置缓冲区大小条数和推送阈值 MemoryHandler memoryHandler new MemoryHandler(targetHandler, 1000, Level.SEVERE); Logger logger Logger.getLogger(com.example); logger.addHandler(memoryHandler); logger.setUseParentHandlers(false); // 通常MemoryHandler单独使用 // 当记录日志时会先进入内存缓冲区 logger.warning(这条警告信息在缓冲区里。); logger.info(这条信息也在缓冲区里。); // 只有当出现SEVERE级别的日志或者手动调用push()或者缓冲区满时才会将缓冲区的所有日志一次性推送给targetHandler logger.severe(严重错误这会触发缓冲区刷新。); // 此时之前的warning和info连同这条severe会一起被写入文件。 // 手动刷新 memoryHandler.push();MemoryHandler减少了I/O次数将多次写操作合并为一次能在一定程度上提升性能。但它仍然是内存中的缓冲并非真正的后台线程异步写入在应用崩溃时缓冲区中未触发的日志可能会丢失。对于严格的异步需求需要考虑更复杂的方案或直接使用Log4j 2的AsyncLogger。5. JUL与第三方日志框架的桥接与对比在现实中一个项目可能使用多种库它们各自可能依赖不同的日志框架。为了避免日志输出四分五裂统一日志管理是必要的。这里就涉及到JUL与其他框架的共存与桥接。5.1 统一门面下的选择SLF4J JULSLF4J是一个日志门面它允许你最终将日志输出委托给任何具体的实现Logback, Log4j 2, JUL等。如果你喜欢SLF4J的API但又不想引入额外的日志实现依赖可以使用slf4j-jdk14这个桥接模块。步骤在项目中引入依赖Maven示例dependency groupIdorg.slf4j/groupId artifactIdslf4j-api/artifactId version2.0.x/version /dependency dependency groupIdorg.slf4j/groupId artifactIdslf4j-jdk14/artifactId version2.0.x/version /dependency代码中使用SLF4J的APIimport org.slf4j.Logger; import org.slf4j.LoggerFactory; public class Slf4jJulDemo { private static final Logger LOGGER LoggerFactory.getLogger(Slf4jJulDemo.class); public void doSomething() { LOGGER.info(Using SLF4J API, but backed by JUL.); LOGGER.error(Error with exception, new RuntimeException(test)); } }日志配置依然使用JUL的机制logging.properties或编程式配置。slf4j-jdk14会将SLF4J的调用转换为对java.util.logging.Logger的调用。这样做的好处是应用代码与具体的日志实现解耦未来可以轻松切换底层日志框架而当前则利用了JDK自带的JUL保持依赖简洁。5.2 接管其他库的日志JUL与Log4j/Logback的桥接更常见的情况是你的应用使用JUL但引入的第三方库如Apache HttpClient, Spring Framework的部分模块内部可能使用了Log4j或Commons Logging。为了让这些库的日志也通过你的JUL配置输出你需要放置相应的桥接JAR包。桥接Commons Logging到JULCommons Logging默认会尝试自动发现日志实现。你可以通过系统属性强制它使用JUL-Dorg.apache.commons.logging.Logorg.apache.commons.logging.impl.Jdk14Logger。更可靠的方式是使用commons-logging的jdk14适配器并确保log4j等JAR不在类路径中迫使它选择JUL。桥接Log4j 1.x到JUL可以使用log4j-over-slf4jslf4j-jdk14的组合将Log4j 1.x的API调用先重定向到SLF4J再定向到JUL。注意log4j-over-slf4j必须替换掉原始的log4j.jar不能共存。桥接java.util.logging到SLF4J如果你决定以SLF4JLogback为主力但想捕获JUL的日志比如Tomcat等容器自身的JUL日志可以引入jul-to-slf4j桥接器并在应用启动早期执行SLF4JBridgeHandler.install()将JUL的日志重定向到SLF4J。这些桥接操作的核心是确保类路径上只有一个“最终”的日志实现并通过桥接器将所有其他日志API的调用路由到这个实现上从而实现日志的统一输出和管理。5.3 特性对比与选型考量最后我们客观地对比一下JUL和主流框架以Log4j 2为例的差异帮助你在实际项目中做出选择。特性维度java.util.logging(JUL)Log4j 2分析与建议内置与依赖JDK自带零额外依赖。需要引入外部JAR包。优势场景对依赖数量敏感的工具、库、小型应用、嵌入式环境。性能早期版本同步IO性能一般。现代JVM中尚可但缺乏真正的异步Appender。性能卓越尤其异步日志AsyncLogger模式几乎不影响主业务线程。对性能有极致要求的高并发服务Log4j 2的异步能力是决定性优势。配置方式支持编程式、logging.properties文件。文件配置功能相对基础。支持XML、JSON、YAML、Properties等多种格式配置能力极其强大和灵活。Log4j 2支持复杂的过滤、路由、脚本条件等适合大型复杂系统的精细化日志管理。输出格式与目标内置Console、File、Socket、Memory Handler。自定义需实现接口。内置数十种Appender文件、Socket、数据库、Kafka、HTTP等生态丰富。需要输出到特定中间件如Kafka、Flume或做复杂分割Log4j 2是首选。过滤与查找支持Level和自定义Filter功能基本。提供基于上下文数据ThreadContext、标记Marker等多维度的强大过滤。需要基于业务标签如用户ID、交易号进行日志筛选和追踪Log4j 2更强大。热更新修改logging.properties后可通过LogManager.readConfiguration()重新加载。支持配置热更新自动检测文件变化对运维更友好。生产环境需要不停机调整日志级别Log4j 2更方便。学习成本与社区API简单文档在JDK中但高级资料较少。功能多学习曲线稍陡但社区活跃资料丰富。新手快速上手简单日志JUL更容易。团队技术栈统一或需要高级功能选Log4j 2。选型心法“够用就好”原则如果你的应用日志需求简单就是分级别输出到文件和控制台且对启动速度和包大小有要求JUL是完全合格甚至优秀的选择。盲目引入重型框架是过度设计。“统一管理”原则在微服务或大型分布式系统中为了统一日志收集、格式和监控通常会强制规定使用某一种日志实现如Log4j 2。此时应遵循团队规范。“渐进式”原则可以从JUL开始。当未来确实遇到性能瓶颈、需要更复杂的日志路由或结构化输出需求时再平滑地通过SLF4J门面切换到Log4j 2或Logback代码层面的改动可以很小。我个人在开发一些命令行工具、小型后台服务或者SDK时非常倾向于使用JUL。它能减少最终交付物的依赖复杂度避免与使用方项目的日志框架产生冲突而且只要配置得当其稳定性和功能性完全能满足日常需求。理解并善用JDK自带的功能是一种务实而高效的做法。