Properties.load() 默认用 ISO-8859-1 解码导致中文乱码,应改用 load(Reader) 配合 UTF-8 的 InputStreamReader;加载配置须用 getResourceAsStream() 并校验非空;写入需用 store(Writer) 指定 UTF-8;Spring Boot 中优先使用 @ConfigurationProperties 而非手动加载。

Properties.load() 读取配置文件时中文乱码怎么办
Java 的 Properties 类默认用 ISO-8859-1 解码,遇到含中文的 .properties 文件会显示为 \u4f60\u597d 这类 Unicode 转义或直接乱码。这不是文件编码问题,而是 load(InputStream) 方法的固有行为。
- 不要用
new FileInputStream("config.properties")直接传给load()—— 它不识别 UTF-8 - 改用
load(Reader)重载,配合InputStreamReader指定编码:try (InputStream is = getClass().getResourceAsStream("/config.properties"); Reader reader = new InputStreamReader(is, StandardCharsets.UTF_8)) { props.load(reader); } - 如果必须用
load(InputStream)(比如兼容旧逻辑),确保源文件保存为 ISO-8859-1 编码,并手动转义中文:用native2ascii工具或 IDE 的 “Convert encoding and escape non-ASCII” 功能
用 ClassLoader.getResourceAsStream() 加载配置比 new FileInputStream() 更可靠
硬编码路径如 "./conf/app.properties" 在 JAR 包、IDE、容器中行为不一致;getResourceAsStream() 基于类路径查找,是标准实践。
- 配置文件放在
src/main/resources/下,运行时自动在 classpath 根目录 - 路径以
/开头表示从 classpath 根开始,例如getResourceAsStream("/db.properties") - 路径不以
/开头则相对于当前类所在包,易出错,避免使用 - 返回
null表示没找到——务必判空,否则抛NullPointerException
Properties.setProperty() 和 setProperty() 不会自动保存到磁盘
Properties 是内存对象,调用 setProperty("key", "value") 只修改 JVM 中的副本,原文件内容不变。
- 要写回文件,需显式调用
store(OutputStream, String)或store(Writer, String) - 写入时注意编码:用
store(Writer, ...)并指定 UTF-8,否则注释和值仍按 ISO-8859-1 输出 - 示例:
try (Writer writer = new OutputStreamWriter( new FileOutputStream("config.properties"), StandardCharsets.UTF_8)) { props.store(writer, "Updated by Java code"); } - 并发修改同一文件时无锁机制,多线程下需自行同步或改用其他配置方案(如 Apache Commons Configuration)
Spring Boot 项目里别直接 new Properties() 读配置
Spring Boot 已通过 @ConfigurationProperties 和 @Value 自动绑定 application.properties,手动用 Properties 会绕过 Spring 的类型转换、校验、刷新机制。
立即学习“Java免费学习笔记(深入)”;
- 需要动态加载外部配置(如用户自定义规则文件),再用
Properties,但应封装为@Component并监听ContextRefreshedEvent - 避免在
@PostConstruct中用getResourceAsStream()读取未被 Spring 管理的配置,可能因 classpath 未就绪而返回 null - 若需兼容 Spring 环境又保留
Properties接口,可用Environment.getProperty("key")替代,它支持占位符、Profile 切换和类型安全
StandardCharsets.UTF_8,如果编辑器保存文件时选了 GBK,或者构建工具(如 Maven Resources Plugin)默认按平台编码拷贝资源,最终打包进 JAR 的仍是乱码文件——得检查源文件编码、IDE 设置、构建插件配置三处。










