Java案例如何实现日志打印？

wen java案例 2026-06-10 9

Java日志打印实战指南：从基础到高阶的全面解析

📚 目录导读

为什么Java项目需要日志？
主流日志框架对比与选择
案例一：使用java.util.logging实现控制台日志
案例二：Logback + SLF4J 打印分层日志
案例三：Log4j2高级配置：异步日志与滚动策略
常见问题与问答
总结与最佳实践

为什么Java项目需要日志？

在Java开发中，日志不是“可有可无”的装饰品，而是系统运行的“黑匣子”，无论是调试bug、监控性能，还是追踪线上事故,日志都不可或缺。

Java案例如何实现日志打印？

核心场景：

故障排查：用户反馈系统异常,通过日志定位具体代码行。
性能分析：记录接口响应耗时,发现慢SQL或内存泄漏。
审计与合规：金融、医疗系统需要记录操作轨迹（如谁在何时修改了数据）。

关键问题：如果日志打印不当（如大量使用System.out.println），会导致生产环境性能下降、磁盘爆满、关键信息被淹没,掌握正确日志打印方法至关重要。

主流日志框架对比与选择

Java生态中最常用的日志框架有三种,各有优劣：

框架名称	特点	性能	适用场景
`java.util.logging` (JUL)	JDK自带的简易日志，无需额外依赖	低	小型应用或快速原型
`Logback`	SLF4J默认实现，配置灵活，支持异步	中高	企业级Spring Boot项目
`Log4j2`	Apache出品，支持异步日志、无锁设计	高	高并发、大数据场景

推荐组合：SLF4J（门面） + Logback（实现）—— Spring Boot默认采用此方案,兼容性强。

注意：避免同时引入多个日志实现，会导致ClassLoader冲突（如同时存在log4j.jar和logback-classic.jar）。

案例一：使用java.util.logging实现控制台日志

1 基础代码

import java.util.logging.Logger;
import java.util.logging.Level;
public class SimpleLogger {
    private static final Logger logger = Logger.getLogger(SimpleLogger.class.getName());
    public static void main(String[] args) {
        logger.info("这是一条INFO级别日志");
        logger.warning("这是一条WARNING级别日志");
        logger.severe("这是一条SEVERE级别日志");
    }
}

2 配置日志级别（通过配置文件）

在项目根目录创建 logging.properties：

handlers = java.util.logging.ConsoleHandler
.level = WARNING
java.util.logging.ConsoleHandler.level = FINE

执行时加载配置：

java -Djava.util.logging.config.file=logging.properties SimpleLogger

缺点：输出格式单一（默认只显示消息和级别），且无法实现滚动日志文件,实际项目不推荐直接使用。

案例二：Logback + SLF4J 打印分层日志

1 添加依赖（Maven）

<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.4.14</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>2.0.9</version>
</dependency>

2 配置logback.xml（放在src/main/resources下）

<configuration>
    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <!-- 文件日志（每天滚动） -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>logs/myapp.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>logs/myapp.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxHistory>30</maxHistory>
            <totalSizeCap>10GB</totalSizeCap>
        </rollingPolicy>
        <encoder>
            <pattern>%d %p %c{1} [%t] %m%n</pattern>
        </encoder>
    </appender>
    <!-- 根日志级别（DEBUG及以上） -->
    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE"/>
    </root>
    <!-- 可单独为某个包设置级别 -->
    <logger name="com.example.service" level="DEBUG" additivity="false">
        <appender-ref ref="CONSOLE"/>
    </logger>
</configuration>

3 在代码中使用占位符（避免字符串拼接）

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class OrderService {
    private static final Logger log = LoggerFactory.getLogger(OrderService.class);
    public void processOrder(String orderId) {
        // ✅ 推荐写法：使用占位符
        log.info("处理订单ID: {}, 用户: {}", orderId, "张三");
        // ❌ 不推荐：字符串拼接（即使未输出也会产生对象）
        // log.info("处理订单ID: " + orderId + " 用户: " + "张三");
        try {
            // 模拟业务逻辑
            Thread.sleep(100);
        } catch (Exception e) {
            log.error("订单处理异常", e); // 传入异常对象，避免丢失堆栈
        }
    }
}

关键点：

%d 时间，%thread 线程名，%level 日志级别（如INFO、ERROR），%logger 全限定类名。
生产环境推荐INFO级别，开发环境可用DEBUG。
日志文件需要设置滚动策略,避免单文件过大。

案例三：Log4j2高级配置：异步日志与滚动策略

1 为什么需要异步日志？

在高并发场景（如每秒处理1000+请求），同步写入日志会阻塞业务线程，导致性能下降，Log4j2通过Disruptor（无锁队列）实现异步写入，吞吐量可提升50%以上。

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>
        <!-- 异步滚动文件 -->
        <RollingFile name="RollingFile" fileName="logs/app.log"
                     filePattern="logs/app-%d{yyyy-MM-dd}-%i.log.gz">
            <PatternLayout pattern="%d %p %c{1.} [%t] %m%n"/>
            <Policies>
                <SizeBasedTriggeringPolicy size="250 MB"/>
                <TimeBasedTriggeringPolicy interval="1"/>
            </Policies>
            <DefaultRolloverStrategy max="20"/>
        </RollingFile>
        <!-- 异步包装（关键） -->
        <Async name="AsyncFile">
            <AppenderRef ref="RollingFile"/>
        </Async>
    </Appenders>
    <Loggers>
        <Root level="info">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="AsyncFile"/>
        </Root>
    </Loggers>
</Configuration>