升级Quarkus至2.16.3.Final后IDE运行主类抛出类找不到异常

问题分析 #

异常栈核心错误为java.lang.NoClassDefFoundError: io/quarkus/bootstrap/resolver/maven/BootstrapMavenContext，该类属于Quarkus的bootstrap模块。Quarkus 2.13版本对IDE运行时的类依赖逻辑做了调整：此前版本中该依赖可能被间接引入，但2.13+版本后需显式添加，直接运行主类会因类路径缺失触发此错误。

解决方案 #

1. 显式添加quarkus-bootstrap-maven-resolver依赖 #

在pom.xml的<dependencies>块中加入以下依赖，补充缺失的类文件：

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-bootstrap-maven-resolver</artifactId>
    <scope>runtime</scope>
</dependency>

2. 使用Quarkus插件专用启动方式 #

避免直接运行主类，改用IDE的Quarkus专属启动配置：

• IntelliJ IDEA：使用带Quarkus图标的Run Configuration（而非普通Application配置）启动应用。
• VSCode：点击Quarkus插件提供的"Start Quarkus App"按钮启动，而非直接运行主类文件。
  Quarkus插件会自动处理IDE运行所需的依赖和类路径，比直接运行主类更可靠。

3. 清理Maven缓存并重新导入依赖 #

执行命令清理本地Maven缓存，避免旧版本依赖残留：

mvn clean install -U

随后在IDE中重新导入Maven项目：

• IntelliJ：File → Reload All Maven Projects
• VSCode：右键pom.xml → Update Project Dependencies

验证 #

完成上述操作后重新启动应用，异常应消失，应用可正常运行。

内容的提问来源于stack exchange，提问作者Jaiprasad