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

Java如何输出日志？

admin
后端开发
2025-06-01
7

在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 (需显式开启) } }

控制台输出：

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

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

<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（推荐方案）

<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>