Java读取配置文件实战教程

本文深入讲解了Java中使用原生java.util.Properties类读取、修改和保存配置文件的实战技巧，涵盖类路径加载、多种资源定位方式（文件路径/URL/字符串）、UTF-8中文编码正确处理、动态配置更新与持久化等核心场景，并强调了生产环境下的安全实践与风险规避，是开发者快速掌握轻量级配置管理的实用指南。

Java中读取配置文件最常用、最轻量的方式就是使用java.util.Properties类，它专为键值对格式（如key=value）的文本配置文件设计，无需额外依赖，原生支持加载、修改和保存。

Properties基础用法：从文件加载配置

Properties本质是一个继承自Hashtable的类，内部以字符串为键和值。读取配置前需确保配置文件（如app.properties）位于类路径下或指定路径中。

常见做法是通过ClassLoader.getResourceAsStream()加载类路径下的文件：

• 创建Properties实例
• 调用load(InputStream)方法传入输入流
• 使用getProperty(String key)获取对应值，可提供默认值避免返回null

示例代码：

db.url=jdbc:mysql://localhost:3306/mydb
db.username=root
db.password=123456

Properties props = new Properties();
try (InputStream is = getClass().getClassLoader().getResourceAsStream("app.properties")) {
    if (is == null) throw new RuntimeException("配置文件未找到");
    props.load(is);
}
String url = props.getProperty("db.url");
String user = props.getProperty("db.username", "guest"); // 提供默认值

支持多种加载方式：文件路径、URL、资源流

除了类路径加载，Properties也支持从绝对/相对文件路径、URL甚至字节数组加载，适应不同部署场景。

• 从文件路径加载：new FileInputStream("config/app.properties")
• 从URL加载：new URL("file:///opt/conf/app.properties").openStream()
• 从字符串加载（适合动态配置）：load(new StringReader("key=value"))

注意：使用文件路径时需处理FileNotFoundException；从URL加载要注意协议支持（如file://、http://）；生产环境推荐优先使用类路径或标准配置目录（如conf/），便于打包管理。

编码与中文乱码问题处理

Properties默认按ISO-8859-1编码读取，若配置文件含中文，直接保存会导致乱码。解决方式有两种：

• 推荐方式：使用load(Reader)重载方法，配合InputStreamReader指定UTF-8编码
• 兼容方式：保持load(InputStream)，但将中文写成Unicode转义（如\u4f7f\u7528\u6237），可用native2ascii工具转换

更简洁的UTF-8加载示例：

try (InputStream is = getClass().getClassLoader().getResourceAsStream("app.properties");
     Reader reader = new InputStreamReader(is, StandardCharsets.UTF_8)) {
    props.load(reader);
}

进阶技巧：动态更新与保存配置

Properties不仅可读，还能在运行时修改并写回文件，适用于简单运行时配置调整（如开关控制、限流阈值）。

• 修改值：props.setProperty("log.level", "DEBUG")
• 保存到文件：store(OutputStream, comment)或store(Writer, comment)
• 保存时支持注释和时间戳（自动添加）

示例：

props.setProperty("feature.enabled", "true");
try (FileOutputStream fos = new FileOutputStream("app.properties")) {
    props.store(fos, "Updated by Java at " + new Date());
}

注意：频繁写配置文件可能引发IO竞争或覆盖风险，生产环境建议仅用于低频、非关键配置；高并发场景应结合配置中心（如Nacos、Apollo）。

以上就是《Java读取配置文件实战教程》的详细内容，更多关于的资料请关注golang学习网公众号！