Properties读取配置最简路径是直接加载.properties文件,需用InputStream避免乱码,优先类路径加载,含中文时指定UTF-8编码;getProperty返回null不报错,须校验加载是否成功。

Java里用Properties读取配置文件最简路径
直接用Properties类加载.properties文件是Java最轻量、最无依赖的配置读取方式,适合单机应用或启动参数简单场景。它不依赖Spring、不需注解、不涉及类路径扫描,只要文件可访问就能读。
关键点:必须用InputStream(不能用FileReader),否则中文乱码;路径优先走类路径(getClass().getResourceAsStream()),避免硬编码绝对路径。
-
Properties默认使用ISO-8859-1编码读取,含中文时需调用load(Reader)并指定UTF-8,或提前对值做StringEscapeUtils.unescapeJava()(若用Apache Commons) - 推荐写法:
Properties props = new Properties(); try (InputStream is = MyClass.class.getResourceAsStream("/config.properties")) { props.load(is); // 无编码问题,但要求文件本身是ISO-8859-1(或ASCII转义中文) } - 若配置文件含原生中文,改用
Reader方式:try (Reader reader = new InputStreamReader( MyClass.class.getResourceAsStream("/config.properties"), StandardCharsets.UTF_8)) { props.load(reader); }
为什么getProperty("key")返回null却没报错
Properties.getProperty()设计就是“查不到就返回null”,不是异常驱动。这容易掩盖拼写错误、路径错位、加载失败等真实问题。
- 常见原因:配置文件根本没加载成功(
is为null),但后续props对象仍可用——只是空的 - 务必在
load()后加校验:if (props.isEmpty()) { throw new IllegalStateException("config.properties not loaded"); } - 用
getProperty(key, defaultValue)替代裸调用,避免NPE,但别滥用——默认值会掩盖配置缺失问题 - 键名区分大小写,
db.url和DB.URL是两个键
加载顺序与覆盖逻辑:多个properties文件怎么合并
Properties本身不提供“多文件合并”能力,putAll()或load()重复调用会覆盖同名键。想实现类似Spring的profile覆盖效果,得自己控制顺序。
立即学习“Java免费学习笔记(深入)”;
- 先加载通用配置(
application.properties),再用props.putAll(otherProps)加载环境专用配置(application-dev.properties) - 注意:
putAll()是浅拷贝,且不会触发原有defaults行为;如需继承式默认,得手动设new Properties(defaults) - 避免用
System.getProperties()混入——它包含JVM启动参数,键名易冲突(如file.encoding) - 若需类型转换(如把
"true"转boolean),别依赖Properties,自己封装getBoolean(key)方法
性能和线程安全:能不能全局静态复用Properties实例
可以,而且推荐。Properties继承自Hashtable,所有方法都同步,线程安全,但代价是并发读性能略低。
- 静态单例足够应付多数场景(如配置只读、启动时加载一次)
- 如果频繁读+偶尔更新,考虑用
ConcurrentHashMap替代,自己管理加载逻辑 - 不要在Web应用中把
Properties存在HttpSession里——它不可序列化(继承自Hashtable,但未实现Serializable) - 敏感配置(如密码)别明文存
.properties,至少用JVM参数-D传入,或对接外部密钥服务










