JavaProperties读取配置方法

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《Java中Properties读取配置文件方法》，聊聊，希望可以帮助到正在努力赚钱的你。

Properties.load() 默认用 ISO-8859-1 解码导致中文乱码，应使用 InputStreamReader 指定 UTF-8；getProperty() 返回 null 多因加载失败、等号非 ASCII 或含不可见字符；System.getProperties() 与自定义 Properties 无关，需显式调用 System.setProperty() 才能生效。

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学习网公众号，给大家分享更多文章知识！