Java读取Properties文件方法解析

本文深入剖析了Java中读取Properties配置文件的常见陷阱与最佳实践，涵盖“Stream closed”异常的根本原因、ClassLoader与Class两种资源加载方式的关键区别、UTF-8中文乱码的可靠解决方案，以及澄清Spring Boot中@Value机制与手动load()完全无关的重要事实；内容直击开发痛点，提供可立即落地的代码范式和避坑指南，助你彻底告别配置加载失败、乱码和资源找不到的困扰。

Properties.load() 读取类路径资源时为什么总报 IOException: Stream closed？

因为 ClassLoader.getResourceAsStream() 返回的流在 Properties.load() 内部调用 readLine() 过程中可能被提前关闭，尤其当资源被包装过（比如 Spring 的 EncodedResource）或流被重复使用时。更常见的是：你手动调用了 close()，而 load() 本身并不负责关流——但它也不假设流已关闭。

实操建议：

• 永远用 try-with-resources 包裹原始输入流，而不是依赖 load() 自动管理
• 不要对 getResourceAsStream() 返回的流做任何二次包装（如 BufferedInputStream 后又转回普通流），除非你明确控制生命周期
• 避免在同一个流上调用多次 load() —— 流只能读一次，第二次会触发 IOException: Stream closed 或空内容

示例正确写法：

try (InputStream is = MyClass.class.getClassLoader().getResourceAsStream("config.properties")) {
    if (is == null) throw new IllegalArgumentException("config.properties not found");
    Properties props = new Properties();
    props.load(is); // 此处不抛异常，且流由 try 自动关闭
}

用 ClassLoader vs Class.getResourceAsStream() 读取 properties 有什么区别？

关键差异在资源查找范围和类加载器委托链。前者走当前线程上下文类加载器（Thread.currentThread().getContextClassLoader()），后者走调用类（MyClass.class）的类加载器。

实操建议：

• Web 应用（如 Tomcat）中优先用 Thread.currentThread().getContextClassLoader().getResourceAsStream()，避免因 WebAppClassLoader 和 SharedClassLoader 分离导致找不到资源
• 单元测试里两者常等价，但若用了自定义 ClassLoader（如 Maven Surefire 插件配置了 useSystemClassLoader=false），Class.getResourceAsStream() 可能失效
• 路径写法必须一致：都用斜杠开头表示绝对路径（/conf/app.properties），不加斜杠是相对路径（app.properties 相对于 MyClass 所在包）

Properties.load() 不支持 UTF-8 中文键值？怎么破？

是的，Properties.load(InputStream) 默认按 ISO-8859-1 解码，遇到中文会变成乱码；而 load(Reader) 版本才支持指定字符集，但要求你自行处理 BOM 和换行兼容性。

实操建议：

• 别用 new InputStreamReader(is, "UTF-8") 直接传给 load(Reader) —— 它无法识别 Windows 换行符（\r\n）中的 \r，会导致解析错行
• 推荐用 Properties.loadFromXML() 配合 UTF-8 编码的 XML 格式配置文件，完全规避编码问题
• 如果必须用 .properties，改用 Files.readString(Paths.get(...), StandardCharsets.UTF_8) 读成字符串后，用 load(new ByteArrayInputStream(str.getBytes(StandardCharsets.ISO_8859_1))) 做一次“假 ISO 转换”——这是 JDK 官方文档隐含的 workaround

Spring Boot 里 @Value("${x.y}") 读不到 properties 是不是 load() 没调用？

不是。@Value 跟手写 Properties.load() 完全无关。Spring Boot 自动加载 application.properties 是通过 ConfigFileApplicationListener + PropertySourcesLoader 实现的，底层用的是 EncodedResource 和自定义解析器，不经过标准 Properties 类。

实操建议：

• 确认配置文件名是否为 application.properties（或 .yml），且位于 src/main/resources/
• 检查 profile 是否匹配：比如激活了 dev，但配置写在 application-prod.properties 里
• 避免在 @Configuration 类的字段上直接用 @Value 注入未初始化的 Properties 对象——Spring 不会帮你调 load()
• 调试时打印 environment.getProperty("x.y")，比看 @Value 更可靠

真正容易被忽略的是：resources 目录下有同名文件（如 application.properties 和 application.yml）时，后者默认优先级更高，前者会被静默忽略。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Java读取Properties文件方法解析》文章吧，也可关注golang学习网公众号了解相关技术文章。