上一篇
Java中，可通过
java.util.logging.FileHandler类新建日志文件，指定文件名与模式；或用Log4j等框架配置实现
使用Log4j框架创建日志文件
添加依赖库
需下载并引入两个核心JAR包：commons-logging-1.1.1.jar和log4j-1.2.15.jar到项目的类路径中,这两个库分别负责基础接口支持和实际的日志功能实现。
配置文件编写（log4j.properties）
在项目的src目录下创建名为log4j.properties的属性文件,内容如下：
# 设置根记录器的级别为DEBUG，并绑定到名为R的Appender log4j.rootLogger=DEBUG, R # 定义名为R的文件输出器（File Appender） log4j.appender.R=org.apache.log4j.FileAppender # 指定日志存储路径与文件名（绝对或相对路径均可） log4j.appender.R.File=/path/to/your/application.log # 可选参数：是否追加模式（默认true）、编码格式等 log4j.appender.R.Append=true log4j.appender.R.Encoding=UTF-8
若需更复杂的结构（如按天滚动归档），可改用XML格式配置（如log4j.xml）,支持正则表达式匹配日期自动分割文件。
代码调用示例
import org.apache.log4j.Logger;
public class MyApp {
private static final Logger logger = Logger.getLogger(MyApp.class);
public static void main(String[] args) {
logger.debug("这是一条调试信息");
logger.info("程序启动成功！");
logger.error("发生未知错误", new Exception("模拟异常"));
}
}
运行后,所有日志将按配置写入指定的文件中。
采用JDK内置的java.util.logging模块
无需第三方库，直接使用标准API即可完成基础需求,此方案适合轻量级应用或快速原型开发。
核心组件说明
关键类包括Handler（处理器）、Formatter（格式化器）和Level（日志等级），其中FileHandler专门用于将日志输出到文件系统。
实现步骤与代码演示
package org.nhooo.example.util.logging;
import java.util.logging.;
import java.io.IOException;
public class SimpleFileLogger {
public static void setup() throws IOException {
// 获取全局日志管理器
Logger globalLogger = Logger.getLogger("");
// 关闭默认控制台输出以避免重复打印
globalLogger.setUseParentHandlers(false);
// 创建文件处理器，参数依次为：文件名、是否追加模式
FileHandler fileHandler = new FileHandler("app_runtime.log", true);
// 设置最低记录级别为INFO及以上
fileHandler.setLevel(Level.INFO);
// 自定义简单文本格式（时间戳+级别+消息内容）
fileHandler.setFormatter(new SimpleFormatter());
// 将处理器添加到日志系统中
globalLogger.addHandler(fileHandler);
}
public static void main(String[] args) throws IOException {
setup(); // 初始化配置
Logger logger = Logger.getLogger(SimpleFileLogger.class.getName());
logger.info("用户登录请求来自IP: 192.168.1.100");
logger.warning("磁盘空间剩余不足20%");
}
}
执行上述代码后，当前工作目录下会生成app_runtime.log文件,包含格式化后的日志条目。
高级实践建议
| 特性 | Log4j优势 | Java UTIL对比 |
|---|---|---|
| 灵活性 | 支持XML/JSON动态加载配置 | 仅代码硬编码或简单属性文件 |
| 性能开销 | 较高（适合生产环境长期运行） | 较低（适合临时调试用途） |
| 社区生态 | 丰富插件体系（如集成SLF4J门面） | 标准库自带但功能较基础 |
| 异常处理机制 | 内置完善的错误捕获与恢复策略 | 需手动处理IO异常 |
对于企业级应用推荐使用Log4j系列工具，因其提供更精细的控制能力和扩展性；而对于小型工具类项目,则可选择原生API以减少依赖。
FAQs相关问答
Q1: 如果运行程序时找不到指定的日志文件怎么办？
A: 首先检查配置文件中的路径是否正确，注意相对路径是基于项目根目录还是执行时的当前工作目录，其次确认应用程序是否有权限在该位置创建/写入文件，可通过在代码中添加如下诊断语句辅助排查：System.out.println("当前工作目录：" + System.getProperty("user.dir"));，如果是权限问题,尝试更换为用户主目录或其他可写区域。
Q2: 如何让日志按日期自动分割成多个历史版本？
A: 在使用Log4j时，可在配置中使用DailyRollingFileAppender组件，设置类似DatePattern='yyyy-MM-dd'的属性值，这样每天凌晨会自动新建一个新文件，例如修改后的XML配置片段如下：<appender type="rolling" class="org.apache.log4j.DailyRollingFileAppender">...</appender>，这种方式能有效防止单个
