Spring Boot集成ActiveMQ Artemis启动时出现NoClassDefFoundError问题

错误原因分析 #

你遇到的java.lang.NoClassDefFoundError: org/apache/activemq/artemis/api/core/QueueConfiguration，本质是JVM运行时找不到编译期预期存在的类。这个类属于ActiveMQ Artemis的核心服务模块，出现该错误的核心原因通常是依赖缺失、版本不兼容或依赖冲突。

解决方案 #

1. 确保使用Spring Boot官方Starter依赖 #

Spring Boot提供的spring-boot-starter-artemis会自动管理所有必要的Artemis依赖，避免手动引入导致的遗漏或版本冲突。

Maven配置：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-artemis</artifactId>
</dependency>

Gradle配置：

implementation 'org.springframework.boot:spring-boot-starter-artemis'

2. 避免手动指定不兼容的Artemis版本 #

Spring Boot 2.7.3的依赖管理中默认绑定的ActiveMQ Artemis版本是2.23.1，如果你手动指定了其他版本，可能会出现类结构不匹配的问题。建议移除自定义的Artemis版本声明，让Spring Boot自动管理版本。

3. 清理依赖缓存并重新构建 #

如果依赖下载不完整，也可能导致类缺失问题：

• Maven执行：

  mvn clean install -U
  

• Gradle执行：

  ./gradlew clean build --refresh-dependencies
  

4. 排查依赖冲突 #

使用依赖分析工具检查是否存在不同版本的Artemis核心库冲突：

• Maven查看依赖树：

  mvn dependency:tree
  

• Gradle查看依赖树：

  ./gradlew dependencies
  

如果发现冲突，在依赖声明中排除低版本或不兼容的Artemis模块。

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