当前位置：首页 > 后端开发 > 正文

Java如何输出日志？

admin
后端开发
2025-06-01
2934

在Java中输出日志通常使用日志框架如Log4j、SLF4J或java.util.logging，基本步骤：导入日志库，获取Logger实例，调用不同级别方法（如logger.info()）输出日志信息，需配置日志级别和输出目的地。

为什么需要日志？

日志记录：

故障排查：快速定位运行时异常
行为追踪：记录用户操作和系统流程
性能监控：通过时间戳分析代码执行效率
安全审计：追踪敏感操作和非规访问

主流Java日志框架对比

框架	特点	适用场景
`java.util.logging` (JUL)	JDK内置，无需额外依赖	小型项目或快速原型
Log4j 2	高性能异步日志，支持JSON/YAML配置	高并发、分布式系统
Logback	Log4j的升级版，与SLF4J无缝集成	Spring Boot默认日志框架
SLF4J	日志门面（抽象层），可对接多种实现	需要灵活切换日志框架的场景

推荐组合：SLF4J + Logback（兼顾灵活性与性能）

4种日志输出实战

JDK原生日志（java.util.logging）

import java.util.logging.*;
public class JULDemo {
    private static final Logger logger = Logger.getLogger(JULDemo.class.getName());
    public static void main(String[] args) {
        // 设置日志级别（默认INFO以上）
        logger.setLevel(Level.ALL);
        // 输出不同级别日志
        logger.severe("严重错误：数据库连接失败");  // SEVERE
        logger.warning("警告：内存使用超70%");     // WARNING
        logger.info("服务启动完成");              // INFO
        logger.config("配置加载");               // CONFIG (需显式开启)
    }
}

控制台输出：

Java如何输出日志？第1张

SEVERE: 严重错误：数据库连接失败
WARNING: 警告：内存使用超70%
INFO: 服务启动完成

Log4j 2 输出日志（需添加依赖）

<!-- pom.xml -->
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.23.1</version>
</dependency>

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
public class Log4j2Demo {
    private static final Logger logger = LogManager.getLogger();
    public static void main(String[] args) {
        logger.fatal("致命错误：系统崩溃");
        logger.error("业务异常：订单提交失败");
        logger.warn("潜在风险：重复请求");
        logger.info("用户登录：ID=1001");
        logger.debug("调试信息：参数={}", "test"); // 支持占位符
        logger.trace("详细跟踪");
    }
}

SLF4J + Logback（推荐方案）

<!-- pom.xml -->
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.5.3</version>
</dependency>

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class LogbackDemo {
    private static final Logger logger = LoggerFactory.getLogger(LogbackDemo.class);
    public static void main(String[] args) {
        logger.error("文件读取失败", new FileNotFoundException()); // 打印异常栈
        logger.info("当前温度: {}℃", 28);  // 参数化日志
        logger.debug("缓存命中率: {:.2f}%", 95.674); // 格式化输出
    }
}

Lombok简化日志声明

import lombok.extern.slf4j.Slf4j;
@Slf4j  // 自动生成log对象
public class LombokLogDemo {
    public static void main(String[] args) {
        log.info("使用Lombok输出日志"); // 直接调用log
    }
}

日志配置最佳实践

日志级别规范

级别	使用场景
ERROR	系统崩溃、核心业务失败等不可恢复错误
WARN	非预期但可恢复的问题（如网络重连）
INFO	关键业务流程节点（启动、停止、重要状态变更）
DEBUG	调试信息（参数值、分支判断）
TRACE	详细执行轨迹（循环内部状态）

️ 生产环境建议设置级别为 INFO 以上

logback.xml 配置示例

<configuration>
    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <!-- 文件滚动日志 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>app.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>app.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
            <maxFileSize>100MB</maxFileSize>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%date %level [%thread] %logger{35} - %message%n</pattern>
        </encoder>
    </appender>
    <!-- 根日志级别 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE"/>
    </root>
</configuration>