JavaProperties读取配置方法详解

Java Properties类虽是配置管理的入门工具，但实际使用中暗藏诸多陷阱：默认ISO-8859-1编码导致中文乱码、getProperty返回null常因加载失败或隐藏字符、System.getProperties()与自定义Properties完全隔离、store方法会破坏原文件格式且不支持增量更新——这些看似细小的问题往往引发线上故障；本文直击核心痛点，给出UTF-8安全读写、精准排错路径和替代方案建议，帮你避开踩坑十年才懂的底层细节，真正用对这个被低估却高频使用的经典API。

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学习网公众号！