升级Axon Server至2023.1.2时遇AXONIQ-2100错误该如何处理？

错误原因 #

单节点免费版从4.*升级到2023.1.2版本时，新版本的集群管理逻辑对单节点场景的初始化流程做了调整：

1. 启动阶段会主动检查_admin上下文的领导者存在性，但单节点此时尚未完成自身的角色注册与初始化，导致触发该错误提示。
2. 若升级时未清理旧的集群元数据，或未显式配置单节点模式，旧配置与新版本逻辑不兼容，也会引发该问题。

解决步骤 #

• 显式启用单节点模式：修改Axon Server配置文件，确保添加或设置axoniq.axonserver.standalone=true，新版本依赖该参数明确标识单节点环境，避免不必要的集群选举逻辑。
• 清理旧集群元数据：停止Axon Server服务后，删除安装目录下data/cluster文件夹（操作前请备份事件数据等重要内容），清除旧版本遗留的集群状态信息，让新版本重新初始化单节点状态。
• 重新启动并等待初始化：启动Axon Server后，等待1-2分钟让节点完成自身注册与角色初始化，单节点环境下会自动成为_admin上下文的领导者，该错误会自行消失。
• 验证节点状态：启动完成后，可通过访问http://<你的节点IP>:8024/v1/public/me接口，查看返回结果中的roles字段是否包含ADMIN，确认节点已成功承担_admin上下文的领导者角色。

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