Java异常日志记录方法与技巧

使用日志框架如Logback记录异常是Java应用排查问题的关键。1. 添加SLF4J与Logback依赖；2. 在代码中通过Logger调用log.error("消息", e)完整输出异常堆栈；3. 配置logback.xml实现日志文件滚动与路径指定；4. 使用占位符传参避免敏感信息泄露；5. 生产环境设为WARN/ERROR级别并集成ELK等分析系统。正确配置和规范记录可有效提升问题定位效率，避免磁盘溢出和信息泄露风险。

在Java应用中，将异常信息记录到日志文件是排查问题的重要手段。正确记录异常可以帮助开发者快速定位错误原因。以下是实现方式和最佳实践。

使用日志框架记录异常

推荐使用成熟的日志框架，如 Logback、Log4j2 或 java.util.logging。这些框架支持结构化输出、日志级别控制和异步写入等功能。

以 Logback 配合 SLF4J 为例：

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

• 代码中记录异常：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class UserService {
  private static final Logger log = LoggerFactory.getLogger(UserService.class);

  public void saveUser(String name) {
    try {
      // 模拟可能出错的操作
      if (name == null) {
        throw new IllegalArgumentException("用户名不能为空");
      }
    } catch (Exception e) {
      log.error("保存用户失败，name={}", name, e); // 自动打印堆栈
    }
  }
}

配置日志输出到文件

通过配置文件指定日志输出路径。Logback 使用 logback.xml 配置：

<configuration>
  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>logs/app.log</file>
    <encoder>
      <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>logs/app.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
      <maxFileSize>10MB</maxFileSize>
    </rollingPolicy>
  </appender>

  <root level="INFO">
    <appender-ref ref="FILE" />
  </root>
</configuration>

这个配置会按天和大小滚动日志文件，避免单个文件过大。

确保完整记录异常信息

只记录异常消息而不打印堆栈是常见错误。应始终传入异常对象作为最后一个参数：

• 正确写法：log.error("操作失败", e); —— 会输出完整堆栈
• 错误写法：log.error("操作失败: " + e.getMessage()); —— 丢失堆栈信息

如果需要包含变量，使用占位符：

log.error("处理用户 {} 时发生异常", userId, e);

生产环境建议

• 设置合适的日志级别，生产环境一般用 WARN 或 ERROR 记录异常
• 定期归档旧日志，避免磁盘占满
• 敏感信息（如密码、身份证号）不要打在日志中
• 考虑集成 ELK 或 Splunk 等日志分析系统

基本上就这些。关键是选择合适框架、正确配置输出路径，并养成规范记录异常的习惯。不复杂但容易忽略细节。