静态代码块在类加载时执行一次,适合一次性初始化配置,需用ClassLoader.getResourceAsStream()读取resources下文件,注意判空、编码和流关闭;但无法依赖Spring环境,现代项目更推荐@ConfigurationProperties等替代方案。

静态代码块在类加载时执行,适合做一次性初始化操作,比如加载配置文件。但要注意它只执行一次,且不能处理需要动态重载的场景。
静态代码块中读取配置文件的基本写法
通常用 ClassLoader.getResourceAsStream() 获取 classpath 下的配置文件(如 properties 或 YAML),再用 Properties 或第三方库解析。推荐放在工具类或配置管理类中,避免分散在多个类里。
- 配置文件建议放在 src/main/resources 目录下,确保能被 classpath 正确识别
- 使用 getClass().getClassLoader().getResourceAsStream("config.properties") 获取输入流,不要用 new FileInputStream(),否则路径易出错
- 记得在 finally 或 try-with-resources 中关闭流,防止资源泄漏
常见问题与注意事项
静态代码块执行时机早于对象创建,也早于 Spring 等框架的 Bean 初始化。如果配置依赖 Spring 环境(如 @Value、Environment),就不能在 static 块里直接注入,需改用其他方式(如 @PostConstruct 方法)。
- 若配置文件不存在,getResourceAsStream() 返回 null,必须判空,否则抛 NullPointerException
- 编码问题:Properties 默认按 ISO-8859-1 解析,含中文需调用 load(new InputStreamReader(in, "UTF-8"))
- 多线程安全:static 块本身是线程安全的(JVM 保证类初始化锁),但后续读取配置的静态变量若可变,需额外同步
替代方案建议
虽然静态代码块能用,但现代 Java 项目更倾向解耦配置加载逻辑。例如:
立即学习“Java免费学习笔记(深入)”;
- 用 static final Properties CONFIG = loadConfig(); 配合私有静态方法封装加载逻辑,更清晰可测
- Spring 项目优先使用 @ConfigurationProperties 或 @PropertySource,由容器统一管理
- 需要热更新配置时,完全避开 static 块,改用监听器 + 定时刷新机制
一个简洁可用的例子
假设 resources/config.properties 内容为 app.name=MyApp:
public class ConfigLoader {
public static final Properties CONFIG = new Properties();
static {
try (InputStream in = ConfigLoader.class.getClassLoader()
.getResourceAsStream("config.properties")) {
if (in == null) {
throw new RuntimeException("config.properties not found in classpath");
}
CONFIG.load(new InputStreamReader(in, StandardCharsets.UTF_8));
} catch (IOException e) {
throw new RuntimeException("Failed to load config", e);
}
}
public static String getAppName() {
return CONFIG.getProperty("app.name", "default");
}
}
调用 ConfigLoader.getAppName() 即可获取值,无需实例化。


















