静态代码块适合预加载与实例无关、启动即需、全应用共享且运行期基本不变的系统级配置,如db_url、max_pool_size、日志级别、预编译pattern、objectmapper单例等;须手动用properties或inputstream加载config.properties,不可用@value或environment,且需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 会让整个类不可用,务必捕获并转为明确错误
- 多个静态变量和块按源码顺序执行,建议把依赖强的配置放在前面
绕过典型坑点:为什么有时“执行了多次”
所谓“只执行一次”,是针对同一个类加载器实例而言。以下情况会导致你以为的“重复执行”:
- Spring Boot 热部署或反复重启时,旧的 WebAppClassLoader 未被回收,新加载器又加载了同一类
- 自定义 ClassLoader、OSGi、Tomcat 多应用部署场景下,同一类被不同加载器分别加载
- 静态块中调用了尚未初始化类的静态字段,引发被动初始化链,可能间接导致循环或异常中断
能读取 application.properties 吗?
不能直接读。因为 static 块执行时 Spring 容器还没启动,@Value、Environment 都不可用。想从配置文件加载值,必须绕过 Spring,用原生 Java I/O 或 Properties 类手动解析:
- 把配置放在 src/main/resources/config.properties
- 用 ClassLoader.getResourceAsStream("config.properties") 加载(路径不要以 / 开头)
- 务必检查返回的 InputStream 是否为 null,资源不存在时不会抛异常,只会返回 null
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











