java 如何打日志
日志框架选择
Java生态中常用的日志框架包括Log4j 2、Logback和java.util.logging (JUL)。推荐使用Log4j 2或Logback,它们性能较好且功能丰富。
添加依赖
对于Maven项目,在pom.xml中添加依赖:
Log4j 2:
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>2.20.0</version>
</dependency>
Logback:
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.4.7</version>
</dependency>
配置文件
Log4j 2配置文件(log4j2.xml):
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<Root level="info">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>
Logback配置文件(logback.xml):
<configuration>
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<root level="INFO">
<appender-ref ref="STDOUT" />
</root>
</configuration>
代码中使用日志
获取Logger实例:
// Log4j 2
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
private static final Logger logger = LogManager.getLogger(YourClass.class);
// Logback
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
private static final Logger logger = LoggerFactory.getLogger(YourClass.class);
记录日志:
logger.trace("This is a trace message");
logger.debug("This is a debug message");
logger.info("This is an info message");
logger.warn("This is a warn message");
logger.error("This is an error message", exception);
日志级别控制
日志级别从低到高分为:
- TRACE:最详细的日志信息
- DEBUG:调试信息
- INFO:程序运行关键点信息
- WARN:潜在问题但不影响程序运行
- ERROR:错误事件影响程序运行
- FATAL:严重错误导致程序终止
最佳实践
使用参数化日志消息避免字符串拼接开销:
logger.debug("User {} logged in at {}", username, loginTime);
异常日志应包含上下文信息和异常对象:

try {
// some code
} catch (Exception e) {
logger.error("Failed to process request for user {}", userId, e);
}
根据环境配置不同日志级别,开发环境可使用DEBUG,生产环境使用INFO或WARN。






