JavaProperties读取配置文件全解析

本文深入剖析了Java中Properties类在实际使用中的三大核心痛点：中文乱码问题（根源在于默认ISO-8859-1编码，需通过InputStreamReader或OutputStreamWriter显式指定UTF-8解决）、getProperty()频繁返回null的隐蔽原因（常因加载失败、非ASCII等号、不可见字符或误用变量展开），以及与System.getProperties()的常见混淆误区（二者完全独立，自定义配置必须显式调用System.setProperty()才能被JVM系统属性机制识别）；同时指出Properties在保存配置时的局限性——不支持增量更新、注释保留和线程安全写入，提醒开发者在复杂配置场景下应果断转向Apache Commons Configuration等专业替代方案。

Properties.load() 读取配置文件时中文乱码怎么办

默认用 load(InputStream) 读取配置文件会按 ISO-8859-1 解码，遇到中文直接变问号或乱码。这不是 Properties 本身的问题，而是输入流没指定字符集。

解决方法是把文件转成 Reader，显式用 UTF-8 打开：

try (InputStream is = getClass().getResourceAsStream("/config.properties");
     Reader reader = new InputStreamReader(is, StandardCharsets.UTF_8)) {
    Properties props = new Properties();
    props.load(reader); // ✅ 正确处理中文
}

• 别用 load(FileInputStream) 直接传文件路径——它不支持编码参数
• getResourceAsStream() 返回的是 classpath 下的流，路径以 / 开头；若读磁盘文件，改用 Files.newBufferedReader(Paths.get("config.properties"), UTF_8)
• Java 9+ 可用 loadFromXML() 配合 UTF-8 的 XML 格式避免乱码，但需改写配置文件结构

Properties.getProperty() 返回 null 的常见原因

调用 getProperty("key") 得到 null，通常不是 key 写错了，而是加载阶段就失败了。

排查顺序如下：

• 确认 load() 没抛异常且执行成功（比如文件不存在会静默失败，只留空 Properties）
• 检查配置文件里是否用了中文等号（如 name＝value），必须是 ASCII 等号 = 或冒号 :
• 确认 key 前后无不可见字符（尤其从 Excel 复制过来的配置容易带 BOM 或全角空格）
• getProperty() 不会自动展开变量（如 ${env}），那是 Spring Environment 才支持的功能

Properties 和 System.getProperties() 混用要注意什么

System.getProperties() 返回的是 JVM 启动参数和系统属性（如 java.version、user.dir），它和你自己 load 进来的 Properties 对象完全无关。

常见误操作：

• 把自定义配置 props.put("db.url", "jdbc:...") 后，错误地认为 System.getProperty("db.url") 能取到——实际取不到
• 想让 logback.xml 读到自定义配置，不能靠 props.setProperty()，得用 System.setProperty() 或启动时加 -Ddb.url=...
• 如果真要合并，用 systemProps.putAll(yourProps)，但注意键名冲突覆盖风险

用 Properties 保存配置时覆盖原文件的坑

store(OutputStream, comment) 默认用 ISO-8859-1 写出，中文又会变乱码；而且它会清空原文件重写，没有增量更新能力。

• 写入前必须包装成 OutputStreamWriter(out, UTF_8)，再调用 store(writer, comment)
• 不要用 new FileOutputStream("config.properties") 直接覆盖——没加锁，多线程写可能损坏文件
• Properties 不支持注释保留、格式缩进、键值顺序维持，频繁修改配置建议换用 Apache Commons Configuration 或 Typesafe Config

真正需要运行时动态读写配置的场景，Properties 只适合最简单的 key-value 场景；一旦涉及嵌套、类型转换、环境隔离，就得换更专业的库。

终于介绍完啦！小伙伴们，这篇关于《JavaProperties读取配置文件全解析》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！