使用CosmosDB for Mongo API的Axon Mongo EventStore索引问题求助

核心前提 #

开启连续备份的Azure Cosmos DB for MongoDB账户，唯一索引必须与集合同时创建，无法在集合创建后添加或修改。Axon默认的MongoEventStorageEngine会自动创建集合并事后添加索引，这直接触发了Cosmos的限制。

解决步骤 #

1. 删除已存在的事件集合

如果之前已经创建了events集合（Axon自动创建或手动创建），必须先删除它——连续备份账户不允许修改现有集合的唯一索引规则。

2. 使用Cosmos扩展命令创建带唯一索引的集合

通过MongoDB客户端执行Cosmos的扩展createCollection命令，一次性创建集合和所需的唯一索引：

MongoDatabase database = mongoClient.getDatabase("your-db-name");

// 构造Cosmos扩展命令，指定集合和唯一索引
Document createCollectionCmd = new Document("create", "events")
        .append("indexes", Arrays.asList(
                new Document("key", new Document("aggregateIdentifier", 1)
                        .append("sequenceNumber", 1))
                        .append("name", "uniqueAggregateIndex")
                        .append("unique", true),
                new Document("key", new Document("timestamp", 1)
                        .append("sequenceNumber", 1))
                        .append("name", "orderedEventStreamIndex")
                        .append("unique", true)
        ));

// 执行命令
database.runCommand(createCollectionCmd);

3. 配置Axon禁用自动索引创建

修改Axon的配置，阻止MongoEventStorageEngine自动创建索引和集合（因为我们已经手动创建了带索引的集合）：

Spring Boot环境配置示例：

@Configuration
public class AxonConfig {

    @Bean
    public MongoEventStorageEngine mongoEventStorageEngine(MongoClient mongoClient,
                                                          Serializer serializer,
                                                          EventUpcaster eventUpcaster) {
        return MongoEventStorageEngine.builder()
                .mongoTemplate(new MongoTemplate(mongoClient, "your-db-name"))
                .eventSerializer(serializer)
                .upcasterChain(eventUpcaster)
                // 禁用自动创建索引
                .storageStrategy(new DocumentPerEventStorageStrategy() {
                    @Override
                    public void ensureIndexes(MongoCollection<Document> eventsCollection) {
                        // 空实现，不执行任何索引创建逻辑
                    }
                })
                .build();
    }
}

4. 验证并启动应用

• 检查Cosmos DB控制台，确认events集合的两个唯一索引已存在
• 启动Axon应用，此时Axon会直接使用已创建的带索引集合，不会触发索引创建操作

为什么之前的方法失败 #

• 重写ensureIndexes失败：新版本Axon的DocumentPerEventStorageStrategy中，ensureIndexes逻辑依赖默认的索引创建流程，强行修改容易引发Axon内部的集合初始化冲突。
• 直接调用createIndex报错：当你执行这段代码时，events集合可能已经被Axon自动创建（无索引），此时连续备份账户不允许添加唯一索引，因此抛出「无法修改唯一索引」的错误；未授权提示通常是Cosmos的权限校验伴随核心限制报错的连带信息，核心问题还是索引创建时机不对。

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