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 写错了,而是加载阶段就失败了。
排查顺序如下:
立即学习“Java免费学习笔记(深入)”;
- 确认
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 场景;一旦涉及嵌套、类型转换、环境隔离,就得换更专业的库。










