Java里Logger类的基本用法是什么_Java日志基础API说明

Java中Logger必须通过Logger.getLogger()获取实例,不可new;日志输出需检查Handler配置与级别设置;推荐用isLoggable()或占位符避免无效拼接;格式化由Handler的Formatter控制。

Java里用Logger前必须先获取实例

Java标准库的java.util.logging.Logger不是直接new出来的,必须通过Logger.getLogger(String name)获取。名字通常用类全限定名(如"com.example.MyService"),这样日志能按模块归类。重复调用同一名字会返回同一个实例,所以一般在类静态字段里初始化:

private static final Logger logger = Logger.getLogger(MyService.class.getName());

别写成new Logger()——它没有公开构造方法,编译就报错。

logger.info()等方法不打印任何内容?检查根处理器

默认情况下,Logger实例本身不输出日志,它把日志交给handler处理。JUL(Java Util Logging)默认只给根Logger配了ConsoleHandler,但子Logger默认useParentHandlers == true,所以多数情况能打到控制台。但如果发现l

ogger.info("test")没输出,常见原因有:

  • Logger被显式设置了setUseParentHandlers(false),又没加自己的Handler
  • LoggerLevel设成了WARNING或更高,而info()INFO
  • 应用服务器(如Tomcat)重置了JUL配置,屏蔽了控制台输出

快速验证:加一行logger.getParent().getLevel()看看根级别是不是INFO或更低。

日志级别和isLoggable()不是摆设

Logger支持SEVEREWARNINGINFOCONFIGFINEFINERFINEST七级,默认启用到INFO。但注意:logger.info("user=" + user)这种写法,不管当前级别是否允许输出,都会先执行字符串拼接——可能浪费CPU或触发副作用(比如user.toString()抛异常)。

正确做法是用isLoggable(Level.INFO)提前判断,或改用带占位符的log(Level.INFO, "user={0}", user)(JUL原生支持{0}语法,仅当真正记录时才解析参数):

if (logger.isLoggable(Level.FINE)) {
    logger.fine("Processing item: " + expensiveToString(item));
}
// 或更简洁:
logger.log(Level.FINE, "Processing item: {0}", item);

别依赖Logger的默认格式,自定义Formatter才可靠

JUL默认用SimpleFormatter,输出类似Jun 12, 2025 3:45:22 PM com.example.MyService doWork INFO: done。时间格式、类名、线程名都固定,很难适配监控系统或ELK。要改输出格式,得替换HandlerFormatter

ConsoleHandler handler = new ConsoleHandler();
handler.setFormatter(new MyCustomFormatter()); // 继承 Formatter 重写 format()
logger.addHandler(handler);

但注意:每个Handler独立持有Formatter,如果同时用了FileHandlerConsoleHandler,得分别设置。另外,Logger本身不保存格式信息,所有格式化逻辑都在Handler侧。

实际项目中,JUL很少单独用到底层定制;更多是作为SLF4J桥接目标,或者被Log4j2/Logback替代。真要用JUL,重点盯住Handler生命周期和Level继承链——这两处出问题,日志就静默消失。