Spring Boot 应用是否支持同时配置 Morphia 和 MongoTemplate

可行性确认 #

完全支持在同一个Spring Boot应用中同时配置使用Morphia和MongoTemplate，二者本质都是对MongoDB Java客户端的上层封装，底层可以复用同一个MongoClient连接实例，不存在原生冲突。

具体配置步骤 #

1. 引入依赖
   首先在项目依赖中同时引入Spring Data MongoDB（含MongoTemplate）和Morphia的相关依赖，注意保持二者依赖的MongoDB Java驱动版本一致，示例Maven依赖如下：

<!-- Spring Data MongoDB 依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-mongodb</artifactId>
</dependency>
<!-- Morphia 依赖 -->
<dependency>
    <groupId>dev.morphia.morphia</groupId>
    <artifactId>core</artifactId>
    <version>2.4.14</version>
</dependency>

2. 配置Morphia复用Spring托管的Mongo实例
   无需额外新建Mongo连接，直接复用Spring Boot自动配置生成的MongoClient实例即可，配置类示例如下：

import dev.morphia.Datastore;
import dev.morphia.Morphia;
import com.mongodb.client.MongoClient;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MorphiaConfig {

    private final MongoClient mongoClient;

    @Value("${spring.data.mongodb.database}")
    private String mongoDbName;

    public MorphiaConfig(MongoClient mongoClient) {
        this.mongoClient = mongoClient;
    }

    @Bean
    public Datastore datastore() {
        Morphia morphia = new Morphia();
        // 仅扫描Morphia专属实体类所在包，避免和Spring Data的@Document实体冲突
        morphia.mapPackage("com.yourproject.domain.morphia");
        Datastore datastore = morphia.createDatastore(mongoClient, mongoDbName);
        // 按需开启索引自动创建
        datastore.ensureIndexes();
        return datastore;
    }
}

3. 直接注入使用
   业务代码中可以按需注入两个组件分别使用：

// 注入MongoTemplate做Spring Data风格操作
@Autowired
private MongoTemplate mongoTemplate;

// 注入Morphia的Datastore做Morphia风格操作
@Autowired
private Datastore datastore;

注意事项 #

• 实体类分区管理: Morphia实体使用@Entity注解，MongoTemplate实体使用@Document注解，建议两类实体存放在完全独立的包路径下，避免组件扫描时出现冲突。
• 连接池复用: 不要为Morphia单独创建新的MongoClient实例，复用Spring自动配置的实例即可，避免产生多余数据库连接浪费资源，也可以保证连接参数（超时、分片配置等）全局统一。
• 版本兼容性: 手动统一指定MongoDB Java驱动版本，避免两个组件依赖的驱动版本不一致出现类加载异常或者API不兼容问题。
• 事务统一管理: 如果同一个业务逻辑中同时使用两个组件执行写操作，可直接使用Spring的@Transactional注解托管MongoDB事务，两个组件会复用同一个事务上下文，保证数据一致性。
• 索引避免重复创建: Morphia的ensureIndexes()和Spring Data MongoDB的spring.data.mongodb.auto-index-creation配置不要同时开启，避免重复校验创建索引带来的性能损耗，生产环境建议关闭自动索引创建，手动统一管理索引。

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