ExceptionInInitializerError是JVM在类静态初始化（静态变量赋值或static块执行）失败时自动封装的包装异常，真正原因需通过栈底“Caused by”定位，常见为NullPointerException、SQLException或NoClassDefFoundError等；其本质是静态初始化不可恢复，一旦失败则类永久不可用，故应避免在static上下文中做高风险操作，推荐改用懒加载模式。
ExceptionInInitializerError 表示类在初始化（即静态变量赋值、静态代码块执行）时抛出了异常，JVM 用它包装了原始异常。它本身不是你写的代码直接 throw 的，而是 JVM 自动封装的“容器异常”，真正的问题藏在它的 cause 里。
看栈顶的 cause 才是关键
打印堆栈时，最上面是 ExceptionInInitializerError，但它下面紧跟着的 Caused by: xxx 才是真实原因。比如：
- 可能是
NullPointerException：静态变量 A 依赖静态变量 B，但 B 初始化时为 null（比如 new 时传了 null 参数）； - 可能是
SQLException：静态块里直接加载数据库驱动并尝试连接，但配置错或服务未启； - 可能是
NoClassDefFoundError：静态块里引用了某个类，该类在运行时缺失（比如依赖 jar 没打进去）。
静态初始化顺序决定错误位置
Java 按源码中声明顺序执行静态变量初始化和静态块。如果第 3 个静态变量初始化失败，前面两个已成功执行，后面的不会执行。排查时要顺着代码从上往下看：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 检查所有
static final常量是否依赖外部资源（如读文件、查 DB）； - 把长静态块拆成小段，每段加日志或 try-catch（临时），定位哪一行崩；
- 注意类继承关系：父类静态初始化先于子类，若父类出错，子类根本不会开始初始化。
避免在静态上下文中做高风险操作
静态初始化阶段无法恢复、不可重试，一旦失败，整个类就永久不可用（后续所有 new 或调用都会再抛这个 Error）。所以应尽量规避：
立即学习“Java免费学习笔记（深入）”；
- 不要在 static 块里初始化数据库连接、HTTP 客户端、线程池等需要外部环境的组件；
- 把复杂初始化逻辑移到首次调用的懒加载方法里（如用
static Holder模式或volatile + double-check）； - 静态常量尽量用编译期确定的值（如
static final int PORT = 8080;），而非运行时计算结果。
复现和验证技巧
这类问题往往只在特定环境触发（如测试环境 OK，生产缺配置）。可这样快速验证：
- 写个最小单元测试，只加载目标类：
Class.forName("YourClass");，观察是否立即报错； - 用 IDE 调试模式启动，在类加载器处设断点（如
ClassLoader.loadClass），步进到静态初始化过程； - 检查类路径、jar 版本、系统属性（如
System.getProperty("env")）是否影响了静态逻辑分支。
