如何在 Java 中通过 static 代码块实现类加载时的初始化配置

胖萱同学_8931

胖萱同学_8931

2026-05-03

583人浏览

原创

是的,静态代码块在类加载时只执行一次,即在JVM类初始化阶段自动执行且仅执行一次,由初始化标记保证线程安全与唯一性,但该“一次”是针对每个类加载器实例而言。

如何在 java 中通过 static 代码块实现类加载时的初始化配置

static 代码块在类加载时真的只执行一次吗

是的,只要类被 JVM 正式加载并完成初始化(即触发 方法),static 代码块就只会执行一次。但要注意:这个“一次”是**针对每个类加载器实例**而言的。如果同一个类被不同类加载器(如自定义 ClassLoader、Tomcat 的 WebAppClassLoader)分别加载,那每个加载器都会独立执行一遍 static 块——这不是 bug,是 JVM 规范行为。

常见误判场景:在 Spring Boot 中反复重启应用(未清空 classloader)、或热部署时看到配置被重复初始化,往往就是类加载器没被回收导致的。

  • 确保初始化逻辑不依赖外部可变状态(比如未加锁的全局 Map)
  • 避免在 static 块中调用可能触发类被动初始化的方法(如访问另一个尚未初始化类的 static 字段)
  • 若需调试,可在块内加 System.out.println("Config loaded by " + ClassLoader.getSystemClassLoader());

static 块里能读取 application.properties 吗

不能直接读。因为 static 块执行时 Spring 容器还没启动,@Value、Environment 都不可用。想从配置文件加载值,必须绕过 Spring,用原生 Java I/O 或 Properties 类手动解析。

典型做法是把配置放在 src/main/resources/config.properties,然后在 static 块里用 ClassLoader.getResourceAsStream() 加载:

static {
    Properties props = new Properties();
    try (InputStream is = MyClass.class.getClassLoader()
            .getResourceAsStream("config.properties")) {
        if (is != null) {
            props.load(is);
            API_TIMEOUT = Integer.parseInt(props.getProperty("api.timeout", "5000"));
        }
    } catch (IOException e) {
        throw new ExceptionInInitializerError(e);
    }
}
  • 路径用相对路径,不要以 / 开头(否则会从 classpath 根目录外查找)
  • 务必检查 is != null,资源不存在时 getResourceAsStream() 返回 null,不是异常
  • 不要在 static 块里做耗时操作(如远程 HTTP 请求),会阻塞整个类初始化,影响所有后续使用该类的线程

和 static 变量初始化顺序冲突怎么办

Java 按源码出现顺序依次执行 static 变量赋值和 static 块,同级之间不能跨行引用未声明的变量。比如下面这段会编译失败:

Java调试
Java调试

通过 JDWP 实现 Java 远程调试:连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP:Java Debug Wire Protocol,Java 调试有线协议(Java 远程调试底层通信协议) remote JVM:远程 Java 虚拟机 step through code:代码单步调试(步入 / 步过 / 步出调试) inspect variables:变量查看 / 变量检视 stac

下载
static {
    DEFAULT_PORT = 8080; // ❌ 编译错误:非法前向引用
}
static int DEFAULT_PORT;

正确顺序必须是声明在前,初始化在后:

static int DEFAULT_PORT;
static String ENV;
static {
    DEFAULT_PORT = Integer.parseInt(System.getProperty("port", "8080"));
    ENV = System.getProperty("env", "dev");
}
  • 所有 static 成员(字段、块)都属于同一初始化阶段,按文本顺序合并进
  • 如果某个 static 字段依赖另一个类的 static 值(如 OtherClass.VERSION),要确认 OtherClass 已被加载,否则会触发其初始化,可能引发死锁或意外行为
  • 优先用 static final 常量替代运行期计算的 static 变量,更安全也更易优化

为什么 log.info() 在 static 块里没输出

很可能是日志框架(如 Logback、Log4j2)的初始化晚于你的类加载。JVM 不保证类加载顺序,而日志框架自身也有 static 初始化逻辑。如果你的类比日志类先加载,那么 log.info() 实际调用的是未配置的 NOP logger,什么都不会打出来。

验证方式:换成 System.err.println(),如果它能输出,基本确定是日志框架未就绪。

  • 最稳妥的做法是不在 static 块里打日志;真需要记录,用 System.err 或写到临时文件
  • 如果必须用 SLF4J,确保日志框架 jar 在 classpath 最前面(Maven 中靠前声明)
  • Spring 环境下,改用 @PostConstruct 或 InitializingBean,它们在容器启动后执行,日志可用且可控

类加载时机不可控,static 块的边界比想象中窄——它只管“类准备好”,不管“环境准备好”。真正关键的配置初始化,往往得往后推一步。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12157

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9242

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7892

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1284

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1028

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1536

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3169

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20431

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1395

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习