Spring Boot中Javers框架无法配置Head与Snapshot集合名称

问题根源 #

你的配置存在两个核心问题：

1. 自定义的MongoRepository未注册为Spring Bean：原方法返回void，Spring无法识别并使用这个自定义实例，Javers自动配置会默认创建自身的MongoRepository，导致自定义集合名不生效。
2. 冗余注解引发冲突：使用javers-spring-boot-starter-mongo时，@ComponentScan(basePackages = "org.javers.spring")和@EnableMongoRepositories("org.javers.spring")属于冗余配置，starter已内置相关逻辑，手动添加可能引发Bean加载冲突。

修正后的配置代码 #

@Configuration
@EnableAspectJAutoProxy
public class JaversSpringMongoApplicationConfig {

    @Autowired
    MongoClient mongoClient;

    @Value("${db.name}")
    String dbName;

    // 关键：将自定义MongoRepository注册为Spring Bean，覆盖自动配置实例
    @Bean
    public MongoRepository javersMongoRepository() {
        return new MongoRepository(
                mongoClient.getDatabase(dbName),
                MongoRepositoryConfiguration.builder()
                        .withSnapshotCollectionName("jv_custom_snapshots")
                        .withHeadCollectionName("jv_custom_head_id")
                        .build()
        );
    }

    // 可选：显式配置Javers实例，确保绑定自定义Repository
    @Bean
    public Javers javers() {
        return JaversBuilder.javers()
                .registerJaversRepository(javersMongoRepository())
                .build();
    }
}

排查验证步骤 #

• 开启调试日志：启动应用时添加--debug参数，查看控制台输出中JaversMongoAutoConfiguration的状态，确认是否因自定义MongoRepositoryBean存在而被跳过。
• 确认配置类扫描范围：确保配置类所在包在Spring Boot默认扫描范围内，或通过@SpringBootApplication(scanBasePackages = "你的配置包路径")指定。
• 清理旧集合：删除MongoDB中原有的jv_snapshots和jv_head_id集合，重启应用后检查新创建的集合名称。
• 检查依赖一致性：确保项目中MongoDB相关依赖（如spring-boot-starter-data-mongodb）的版本与Javers starter兼容，避免版本冲突。

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