Spring Boot项目中Axon Framework事件处理器无法捕获事件求助

1. 核对查询服务的Axon核心配置 #

• 要确认application.properties/application.yml里Axon Server地址配置正确，和命令服务用的是同一个Axon Server实例：

  axon.axonserver.servers=localhost:8124 # 替换成你的Axon Server实际地址
  

• 必须开启追踪模式的事件处理器，添加配置（如果没指定处理器分组名，默认用default即可）：

  axon.eventhandling.processors.default.mode=tracking
  axon.eventhandling.processors.default.initial-sequence=0
  

2. 验证事件处理器的注册与注解 #

• 查询端的事件处理器类得加@Component或者Spring其他组件注解，确保能被Spring扫描并加载到容器里。
• 事件处理方法必须用@EventHandler注解，而且参数必须是两端完全一致的共享事件类实例（包路径、类名、字段都不能有差异）：

  @Component
  public class OrderQueryHandler {
      @EventHandler
      public void handle(OrderCreatedEvent event) {
          // 你的事件处理逻辑
      }
  }
  

3. 确保事件序列化的一致性 #

• 命令、查询服务的共享事件类要完全一致：包名、类名、字段定义，包括序列化相关的注解（比如用Jackson时的@JsonTypeInfo）都不能有差别，否则Axon Server传递的事件到查询端会无法识别。

4. 检查Axon Server的状态与事件流 #

• 登录Axon Server后台，查看Event Store里目标事件是否存在，且事件的payloadType要和查询端事件类的全限定名完全匹配。
• 查看Processing Groups板块，确认查询服务的事件处理器已经注册，状态是RUNNING，并且分配了处理Segment。

5. 核对依赖版本适配性 #

• 确保查询服务引入的Axon Starter依赖版本和命令服务一致，而且要适配Spring Boot 3.1：

  <dependency>
      <groupId>org.axonframework</groupId>
      <artifactId>axon-spring-boot-starter</artifactId>
      <version>4.9.x</version> <!-- 该版本适配Spring Boot 3.1 -->
  </dependency>
  

6. 开启日志排查细节 #

• 在查询服务里添加日志配置，打印Axon相关的DEBUG日志，排查是否有注册失败、事件接收异常、反序列化错误等信息：

  logging.level.org.axonframework=DEBUG
  

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