静态代码块在类加载的初始化阶段执行且仅一次，用于驱动注册、配置加载等一次性初始化；按声明顺序执行，早于构造器，线程安全，但抛异常会导致类初始化失败。
静态代码块在 Java 中是类加载阶段（Class Loading Phase）执行的最早可编程入口之一，适合用于驱动初始化、全局资源预加载、配置挂载等“一次且仅一次”的初始化逻辑。它在类首次被主动使用（如 new 实例、调用静态方法、访问静态字段等）前，由 JVM 自动触发，且保证线程安全（JVM 保证同一类的静态初始化只执行一次）。
静态代码块执行时机与关键特性
静态代码块在类加载的 初始化（Initialization）阶段 执行，早于任何构造器、实例代码块，也早于 main 方法。其核心特点包括：
- 按声明顺序执行，多个静态块从上到下依次运行
- 仅执行一次，即使后续创建多个实例或多次反射加载（ClassLoader 级别隔离）
- 若初始化过程抛出未捕获异常（如 ExceptionInInitializerError），该类将永久处于“初始化失败”状态，后续所有使用均抛出 NoClassDefFoundError
- 天然线程安全：JVM 通过类锁（Class object monitor）确保并发场景下只执行一次
典型应用场景与实现方式
以下为常见且实用的初始化模式，适用于 JDBC 驱动注册、日志框架绑定、配置中心客户端挂载、全局缓存预热等场景：
JDBC 驱动自动注册（传统方式，兼容老版本）
public class DatabaseDriverLoader {
static {
try {
Class.forName("com.mysql.cj.jdbc.Driver"); // 触发 Driver 静态块注册
} catch (ClassNotFoundException e) {
throw new ExceptionInInitializerError("MySQL JDBC Driver not found", e);
}
}
}
⚠️ 注意：JDBC 4.0+ 已支持 SPI 自动发现，无需显式 Class.forName，但静态块仍可用于兜底或定制化注册逻辑。
预加载配置并挂载到全局上下文
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
public class AppConfig {
public static final Map<string string> PROPERTIES = new HashMap();
static {
try (InputStream is = AppConfig.class.getResourceAsStream("/app.properties")) {
if (is != null) {
Properties props = new Properties();
props.load(is);
props.stringPropertyNames().forEach(key ->
PROPERTIES.put(key, props.getProperty(key))
);
} else {
throw new IllegalStateException("app.properties not found in classpath");
}
} catch (IOException e) {
throw new ExceptionInInitializerError("Failed to load app.properties", e);
}
}
}</string>
后续代码可直接使用 AppConfig.PROPERTIES.get("db.url")，无需重复加载。
初始化单例资源（轻量级，无延迟加载需求时）
public class GlobalCache {
public static final Cache<string object> INSTANCE;
static {
INSTANCE = Caffeine.newBuilder()
.maximumSize(10_000)
.expireAfterWrite(10, TimeUnit.MINUTES)
.build();
// 可选：预热基础数据
INSTANCE.put("system.status", "READY");
}
}</string>
注意事项与避坑指南
静态代码块看似简单，但误用易引发隐性故障：
- 避免耗时操作：网络请求、大文件读取、复杂计算会阻塞类加载，拖慢整个应用启动；应考虑异步化或延迟到首次使用时（如用静态内部类 Holder 模式）
- 禁止依赖尚未初始化的其他类静态字段：循环依赖会导致 NoClassDefFoundError 或 IllegalAccessError；可通过提取独立初始化类解耦
- 慎用 System.setProperty / Logger 配置：若日志框架尚未完成初始化（如 Logback 在 StaticLoggerBinder 之后才生效），可能静默失效；建议优先使用框架推荐的初始化方式（如 logback.xml）
- 不可用于需要参数化的初始化：静态块无入参，无法根据环境（dev/test/prod）动态选择配置；此时应改用 @PostConstruct、Spring @Bean 初始化方法，或主函数中显式调用 init() 方法
替代方案对比（何时不该用静态块）
当初始化逻辑具备以下特征时，建议选用更可控的机制：
- 需依赖 Spring 容器（如注入 DataSource、RestTemplate）→ 使用
@PostConstruct或@Bean(initMethod = "...") - 需按需加载（节省内存/启动时间）→ 使用懒汉式单例 + 双重检查锁，或 Java 8+ 的
ConcurrentHashMap.computeIfAbsent - 涉及多阶段或可重试逻辑 → 封装为独立 Service，在 ApplicationRunner / CommandLineRunner 中触发
- 需统一生命周期管理（如关闭资源）→ 静态块无法对应“销毁”，应改用实现 AutoCloseable 的组件 + 显式 shutdown 调用
静态代码块是 JVM 提供的底层确定性初始化机制，适合无依赖、轻量、幂等的预配置任务。合理使用能提升启动效率与代码简洁性，但绝不应成为“万能初始化筐”。关键在于明确初始化边界——它是类契约的一部分，不是业务流程的起点。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
