Java配置文件读取实战教学

哈喽！今天心血来潮给大家带来了《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）。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~