AxonServer连接失败报错AXONIQ-1302：default上下文不在复制组中

核心根源：版本兼容性不匹配 #

AxonServer 2023.1.2属于企业版，引入了「复制组（Replication Group）」集群管理特性，但你使用的axon-spring-boot-starter 4.5.3对应Axon Framework 4.5.x版本，该版本仅适配Axon Server社区版，无法识别企业版的复制组配置逻辑，因此会触发AXONIQ-1302错误，提示找不到默认的default复制组。

具体解决步骤 #

1. 调整版本适配 #

• 方案一：升级框架版本
  若继续使用AxonServer 2023.1.2企业版，需将Axon Framework依赖升级至4.6.0及以上版本，该版本开始正式支持Axon Server企业版的复制组特性。
  Maven依赖示例：

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

• 方案二：降级AxonServer版本
  若坚持使用4.5.3版本的starter，需将AxonServer替换为2022.0.0及以下的社区版，该版本尚未引入复制组概念，可与4.5.x框架兼容。

2. 显式配置复制组（仅企业版+适配框架版本适用） #

升级框架后仍报错的话，需在Spring Boot配置文件中明确指定复制组名称：

# application.properties
axon.axonserver.replication-group=default

或YAML格式：

# application.yml
axon:
  axonserver:
    replication-group: default

3. 验证AxonServer配置 #

登录8024端口的Web控制台，进入Clustering菜单，检查Replication Groups列表，确认default复制组存在且包含当前AxonServer节点。

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