怎样用Java的日志框架（如Log4j或java.util.logging）记录程序运行状态

wen java案例 2026-06-04 56

如何用Java日志框架（Log4j与java.util.logging）精准记录程序运行状态

目录导读

为什么Java程序必须拥抱日志系统
两大主流日志框架对比：Log4j vs java.util.logging
Log4j 2实战：从入门到企业级配置
java.util.logging（JUL）基础用法与调优
日志最佳实践：记录什么、何时记录、如何轮转
常见问题问答（Q&A）
总结与性能建议

为什么Java程序必须拥抱日志系统

在开发过程中，开发者经常通过 System.out.println() 输出调试信息，但这种方式无法满足生产环境的需求。日志框架提供了分级输出、文件滚动、异步写入、远程传输等核心能力，根据搜索引擎的资料汇总，大约70%的线上故障排查依赖于日志分析，而直接控制台输出会导致磁盘溢出、性能下降以及无结构混乱。

怎样用Java的日志框架（如Log4j或java.util.logging）记录程序运行状态

日志框架核心价值

故障定位：通过 ERROR、WARN 级别快速找到异常点。
性能监控：记录请求响应时间、内存使用、线程池状态。
审计溯源：记录用户操作轨迹,符合合规要求。
动态调整：无需重启即可调整日志级别（如切换到 DEBUG 级）。

两大主流日志框架对比：Log4j vs java.util.logging

特性	Log4j 2	java.util.logging (JUL)
性能	异步日志+无锁设计，极低延迟	同步写入，高并发下有竞争
配置灵活性	XML/JSON/YAML/Properties	仅Properties或代码配置
日志级别	TRACE > DEBUG > INFO > WARN > ERROR > FATAL	SEVERE > WARNING > INFO > CONFIG > FINE > FINER > FINEST
主流生态	与Slf4j完美结合，Spring Boot默认	JDK内置，无需额外依赖
文件轮转	基于时间、大小、组合策略	需配合 `FileHandler` 配置
社区活跃度	高，持续更新（如修复Log4Shell漏洞）	维护缓慢，不建议新项目使用

对于新项目，推荐使用 Log4j 2 + Slf4j 组合；若项目依赖JDK原生无外部库,则选用JUL。

Log4j 2实战：从入门到企业级配置

1 快速集成（Maven依赖）

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.20.0</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
    <version>2.0.7</version>
</dependency>

2 log4j2.xml 经典配置（记录控制台+文件）

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="INFO">
    <Appenders>
        <!-- 控制台输出 -->
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{yyyy-MM-dd 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{yyyy-MM-dd HH:mm:ss} [%t] %-5level %c{1}:%L - %msg%n"/>
            <Policies>
                <TimeBasedTriggeringPolicy />
                <SizeBasedTriggeringPolicy size="10 MB"/>
            </Policies>
            <DefaultRolloverStrategy max="20"/>
        </RollingFile>
    </Appenders>
    <Loggers>
        <Root level="INFO">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile"/>
        </Root>
    </Loggers>
</Configuration>

3 在代码中记录运行状态

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class PaymentService {
    private static final Logger logger = LoggerFactory.getLogger(PaymentService.class);
    public boolean processPayment(String orderId, double amount) {
        logger.info("开始处理订单: {}, 金额: {}", orderId, amount);
        try {
            // 业务逻辑...
            logger.debug("数据库扣款成功: {}", orderId);
            return true;
        } catch (Exception e) {
            logger.error("订单 {} 支付失败，原因: ", orderId, e); // 注意：参数传递异常对象
            return false;
        }
    }
}

java.util.logging（JUL）基础用法与调优

1 原生配置示例（logging.properties）

handlers= java.util.logging.ConsoleHandler, java.util.logging.FileHandler
.level= INFO
java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.FileHandler.pattern = logs/jul_%u.log
java.util.logging.FileHandler.limit = 50000
java.util.logging.FileHandler.count = 10
java.util.logging.FileHandler.level = ALL
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter

2 代码实现

import java.util.logging.Level;
import java.util.logging.Logger;
public class OrderManager {
    private static final Logger logger = Logger.getLogger(OrderManager.class.getName());
    public void confirmOrder(Long orderId) {
        logger.config("开始确认订单: " + orderId); // CONFIG级别
        logger.info("订单确认成功: " + orderId);
        logger.warning("注意: 订单库存不足: " + orderId);
        logger.fine("具体商品清单: " + getDetail()); // 更细粒度
    }
}

注意：JUL默认日志级别为INFO，若要开启FINE/FINER，需在配置或代码中显式设置 logger.setLevel(Level.ALL)。

日志最佳实践：记录什么、何时记录、如何轮转

1 记录内容的黄金原则

不要记录敏感信息：如密码、银行账号、信用卡CVV（可用****掩码）。
记录业务关键路径：如请求参数、状态流转结果、异常堆栈。
使用参数化日志：logger.info("用户 {} 登录成功", userId),避免字符串拼接。
定义统一日志ID：如 traceId,用于分布式链路追踪。

2 何时调整日志级别

生产环境：WARN 或 ERROR，若需排查可用 INFO，白天高峰避免 DEBUG。
测试/预发布：INFO 或 DEBUG。
压测阶段：暂时关闭除 ERROR 外的所有日志，避免I/O瓶颈。

3 文件轮转策略

基于大小：单文件超过10MB自动切割。
基于时间：每天生成一个新文件。
组合策略：如“每天切分 + 每个文件最大50MB”,保留最近30天的日志。
压缩历史：使用.gz压缩，可节省80%存储空间。
归档位置：存放与系统盘分离的挂载点,避免填满根目录。

常见问题问答（Q&A）

Q1：Log4j 与 Log4j 2有什么区别，升级需要注意什么？

A：Log4j 2完全重写架构，引入异步日志（性能提升10倍）、无锁队列、插件系统，升级后配置格式从 .properties 改为主推XML/JSON，且 Appender 类名不同（如 RollingFile 代替 DailyRollingFileAppender），注意排除旧版依赖冲突（如与 log4j-over-slf4j 的循环依赖）。

Q2：如何避免日志框架影响系统性能？

A：1）使用异步追加器：AsyncAppender 或 Log4j 2的 asyncLogger；2）调整缓冲区大小（如 BufferedIO=2000）；3）定期归档日志；4）生产环境只记录必要级别（INFO），避免 DEBUG 中打印SQL、对象全字段。

Q3：log4j2.xml 中使用 %replace 过滤敏感数据可行吗？

A：可以，例如过滤身份证号：<PatternLayout pattern="%msg{replace=/\d{17}[\dX]/***}"/>,但更建议在业务层先脱敏再传参。

Q4：Java原生日志框架（JUL）是否已被淘汰？

A：JUL依然被JDK维护，适用于对第三方库无依赖的轻量程序，但缺少像Log4j 2的异步写入、JSON格式化、动态刷新等高级功能，且多层类加载器环境下可能出现混乱,推荐用于简单工具类或培训项目。

Q5：如何实现全局请求链路ID的日志注入？

A：使用MDC（Mapped Diagnostic Context）机制，Log4j 2中调用 ThreadContext.put(“traceId”, UUID.randomUUID().toString())，然后在Pattern中使用 %X{traceId}；在请求过滤器模式下即可全局生效。