Spring Boot应用未显示在Axon Dashboard且CommandGateway Bean缺失求助

架构老林

2026-8-9

问题解决指南

1. 修复版本一致性问题

项目中java.version配置为17，但maven-compiler-plugin的source/target设置为16，编译与运行环境不一致会干扰Axon自动配置。修改maven-compiler-plugin配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
        <source>17</source>
        <target>17</target>
        <!-- 其他注解处理器配置保持不变 -->
    </configuration>
</plugin>

2. 适配Spring Boot 3的Axon依赖

Axon Framework 4.6.x支持Spring Boot 3，建议升级到最新4.6.x版本提升兼容性：

<dependency>
    <groupId>org.axonframework</groupId>
    <artifactId>axon-spring-boot-starter</artifactId>
    <version>4.6.7</version>
</dependency>

3. 配置Axon Server连接

在application.properties中添加Axon Server配置，让应用注册到Dashboard：

# 本地Axon Server默认地址
axon.server.url=http://localhost:8124
# 应用名称，将显示在Axon Dashboard中
axon.application.name=user-ws

4. 确保Axon自动配置生效

检查Spring Boot主类的@ComponentScan范围，避免限制过窄导致Axon配置类无法加载
确认配置类中没有排除Axon自动配置（如@SpringBootApplication(exclude = AxonAutoConfiguration.class)），如有则移除该配置

5. 手动配置CommandGateway（临时方案）

若自动配置仍未生成CommandGateway Bean，可手动添加配置类：

import org.axonframework.commandhandling.gateway.CommandGateway;
import org.axonframework.commandhandling.gateway.DefaultCommandGateway;
import org.axonframework.commandhandling.CommandBus;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class AxonConfig {
    @Bean
    public CommandGateway commandGateway(CommandBus commandBus) {
        return DefaultCommandGateway.builder()
                .commandBus(commandBus)
                .build();
    }
}