静态代码块是类初始化阶段执行且仅一次的天然入口，适合全局配置预加载；按源码顺序执行、线程安全，但需手动加载资源、异常兜底并声明为final以保障不可变性。
静态代码块是类加载时执行一次的天然入口，适合做全局配置的预加载——它不依赖 Spring 容器、无需手动触发、线程安全，但必须避开常见陷阱才能真正“一次性”生效。
明确适用场景：哪些配置适合放 static 块
适合初始化那些与实例无关、启动即需、全应用共享、且值在运行期基本不变的配置项，例如：
- 数据库连接字符串（
DB_URL）、最大连接数（MAX_POOL_SIZE） - 日志级别、监控开关等系统级常量
- 预计算的正则 Pattern、JSON 解析器（
ObjectMapper）单例 - 从
config.properties或app.yml手动读取的基础参数
正确写法：按顺序加载 + 异常兜底 + final 保障
静态块要真正“只执行一次”，关键不是写个 static{} 就完事，而是保证初始化逻辑完整、失败可感知、结果不可变：
- 把配置字段声明为
public static final，避免后续被意外修改 - 用
Properties或InputStream手动加载资源，不能依赖@Value或Environment（此时 Spring 还没启动） - 所有 IO 操作必须包裹
try-catch，抛出ExceptionInInitializerError会让整个类不可用，务必捕获并转为明确错误 - 多个静态变量和块按源码顺序执行，建议把依赖强的配置放在前面
public static final String DB_URL;
public static final int MAX_POOL_SIZE;
public static final Logger LOGGER;
static {
Properties props = new Properties();
try (InputStream is = AppConfig.class.getResourceAsStream("/app.properties")) {
if (is == null) {
throw new IllegalArgumentException("app.properties not found in classpath");
}
props.load(is);
} catch (Exception e) {
throw new ExceptionInInitializerError("Failed to load AppConfig", e);
}
DB_URL = props.getProperty("db.url", "jdbc:h2:mem:test");
MAX_POOL_SIZE = Integer.parseInt(props.getProperty("pool.size", "10"));
LOGGER = LoggerFactory.getLogger(AppConfig.class);
LOGGER.info("AppConfig initialized, DB_URL={}", DB_URL);
}
绕过典型坑点：为什么有时“执行了多次”
所谓“只执行一次”，是针对同一个类加载器实例而言。以下情况会导致你以为的“重复执行”：
- Spring Boot 热部署或反复重启时，旧的
WebAppClassLoader没被回收，新加载的类被视为不同类，static 块再走一遍 - 自定义 ClassLoader 加载同一份字节码，每个加载器都会独立初始化
- 在 static 块里调用了另一个尚未初始化类的静态字段，可能触发连锁初始化，打乱预期顺序
- 配置文件路径写错（如漏掉
/），getResourceAsStream()返回 null，后续props.load(null)报 NPE，导致初始化失败却不报错
进阶建议：轻量级 + 可观测 + 可调试
生产环境用 static 块初始化，还要考虑可观测性和维护性：
- 在块开头加日志，打印当前类加载器：
System.out.println("Loaded by: " + AppConfig.class.getClassLoader()); - 避免耗时操作：不要在块里发 HTTP 请求、连远程 Redis 或解析大 JSON——会拖慢启动，且失败无法重试
- 若配置来自外部系统（如 Apollo、Nacos），改用懒加载 + 双重检查锁，而不是塞进 static 块
- 测试时可主动触发类加载：
Class.forName("AppConfig");，验证是否如期初始化
