应使用Log4j2等成熟日志框架而非手动文件写入，因其支持线程安全、异步、滚动归档与自动压缩；配置log4j2.xml可实现按天/大小切分、保留7个归档；代码中通过Logger.info()等API记录日志，支持占位符和异常自动堆栈。
Java 中写日志不等于直接用 FileWriter 或 PrintStream 往文件里塞字符串——那样既难维护，又容易在多线程、滚动、异步等场景下出问题。真正可靠的做法是用成熟日志框架，比如 Log4j2 或 SLF4J + Logback。
为什么别手写文件写入日志
手动打开 FileOutputStream、加锁、格式化时间、处理换行、判断文件大小、切分归档……这些逻辑看似简单，实则极易出错：
- 并发写入时可能丢日志或损坏文件（没加同步/没用线程安全的
Appender） - 大流量下阻塞主线程（同步 I/O 未异步化）
- 磁盘满时程序崩溃（没配置
failures回退策略） - 日志轮转失效（比如按天切分但
SimpleDateFormatter线程不安全）
Log4j2 配置文件写法（log4j2.xml）
这是最轻量、无需代码侵入的落地方式。把以下内容存为 src/main/resources/log4j2.xml：
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<RollingFile name="RollingFile" fileName="logs/app.log"
filePattern="logs/app-%d{yyyy-MM-dd}-%i.log.gz">
<PatternLayout>
<Pattern>%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n</Pattern>
</PatternLayout>
<Policies>
<TimeBasedTriggeringPolicy />
<SizeBasedTriggeringPolicy size="10MB" />
</Policies>
<DefaultRolloverStrategy max="7"/>
</RollingFile>
</Appenders>
<Loggers>
<Root level="info">
<AppenderRef ref="RollingFile"/>
</Root>
</Loggers>
</Configuration>关键点：
立即学习“Java免费学习笔记（深入）”；
Java 接口排错助手
下载
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
-
fileName是当前活跃日志路径；filePattern定义归档名，支持压缩（.gz） -
TimeBasedTriggeringPolicy按天滚动；SizeBasedTriggeringPolicy单文件超 10MB 就切 -
max="7"表示最多保留 7 个历史归档，超出自动删除 - 首次运行会自动创建
logs/目录，无需提前mkdir
Java 代码中怎么记一条日志
不用 new 任何流，只用标准 API：
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
<p>public class MyApp {
private static final Logger logger = LogManager.getLogger(MyApp.class);</p><p>public void doSomething() {
logger.info("User login: {}", "alice");
logger.error("DB connection failed", new SQLException("Connection refused"));
}
}注意：
- 占位符
{}比字符串拼接更高效（异常堆栈不计算，除非日志级别开启） - 传异常对象时，Log4j2 会自动打印完整堆栈，不用调
e.printStackTrace() - 如果类名改了，
MyApp.class仍能准确绑定日志器，避免硬编码字符串
常见陷阱与绕过方法
几个高频翻车点：
- 引入了
log4j-core但漏掉log4j-api→ 报NoClassDefFoundError: org.apache.logging.log4j.spi.AbstractLogger - Maven 里同时存在 log4j 1.x 和 2.x → 类加载冲突，删掉
log4j:log4j旧包 - IDE 运行时 classpath 没加载
log4j2.xml→ 检查是否在target/classes下，不是src/main/resources路径不对 - 想异步但只加了
AsyncLogger标签，没加 JVM 参数-Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector→ 异步不生效
日志框架的配置粒度很细，但核心原则就一条：让日志行为可预测、可收敛、可追溯。手写文件操作在 Demo 里跑得通，在生产环境里大概率成为第一个被拔掉的模块。
