静态代码块是类加载时执行的一次性初始化入口,适合早期加载配置等资源,需用ClassLoader从classpath加载文件、判空处理、日志反馈及避免绝对路径等陷阱。

静态代码块是类加载时执行的一次性初始化入口,适合在应用启动早期加载配置、驱动或静态资源。它天然线程安全、只运行一次,但失败会阻断整个类的使用,所以读取资源时需兼顾健壮性和可诊断性。
用 ClassLoader 加载 classpath 下的 properties 文件
这是最常用也最推荐的方式:把 config.properties 放在 src/main/resources 目录下,Maven/Gradle 会自动将其复制到 classpath 根路径。静态代码块中通过类加载器获取输入流,再用 Properties 解析:
- 使用 Class.getClassLoader().getResourceAsStream("config.properties"),路径不带斜杠,表示从 classpath 根开始找
- 务必用 try-with-resources 确保流关闭,避免资源泄漏
- 对 null 输入流做判空处理,防止静默失败;异常建议包装为 ExceptionInInitializerError,便于定位问题
用当前类对象加载同包或子路径下的资源
如果资源文件和 Java 类放在同一包(如 com.example.config/app.conf),可用类对象直接加载:
- MyConfig.class.getResourceAsStream("app.conf"):加载同包下的文件
- MyConfig.class.getResourceAsStream("/static/logo.png"):加斜杠表示从 classpath 根开始,适用于 resources/static/ 下的二进制资源
- 注意:getResourceAsStream 返回 null 表示没找到,不会抛异常,必须主动检查
加载失败时提供清晰反馈和兜底逻辑
生产环境不能容忍配置缺失却无提示。静态块中应避免仅调用 e.printStackTrace():
立即学习“Java免费学习笔记(深入)”;
- 捕获 IOException 后,记录带上下文的日志(如“Failed to load config.properties: file not found or unreadable”)
- 关键配置缺失时,可设默认值(如 properties.getProperty("timeout", "5000")),或抛出带说明的初始化错误
- 若资源是二进制文件(如字体、证书),建议用 ByteArrayOutputStream 一次性读入内存,避免后续反复打开流
避免常见陷阱
几个高频出错点需特别注意:
- 不要用 new FileInputStream("xxx.properties")——这是绝对路径,打包后必失败
- 不要在静态块里调用尚未初始化的其他静态字段,可能引发初始化循环或 NPE
- 多个静态块按声明顺序执行,把资源加载放在靠前位置,供后续静态变量使用
- Web 应用中,确保资源文件最终出现在 WEB-INF/classes/ 或 jar 的根目录下,否则 getResourceAsStream 找不到


















