Apache Jackrabbit Oak 1.68与MongoDB 5.0兼容问题及驱动报错求助

问题根源 #

1. 文档滞后：官方文档的示例代码未同步更新到MongoDB 4.x+驱动的API，com.mongodb.MongoClient确实是3.x驱动的专属API，4.x+版本已被MongoClients替代。
2. 版本不匹配：Oak 1.68.0对MongoDB驱动有特定版本要求，直接降级到3.12.14会缺失Oak依赖的新类（比如com.mongodb.operation.ReadOperation是4.x+驱动引入的），从而触发ClassNotFoundException。

正确配置步骤 #

1. 匹配兼容的依赖版本 #

Oak 1.68.0官方推荐搭配MongoDB 5.0，但对应的驱动版本需选择4.6.x或5.0.x（避免用最新的5.1.x，可能存在未适配的API变更）。调整后的Maven依赖如下：

<dependency>
    <groupId>org.apache.jackrabbit</groupId>
    <artifactId>oak-core</artifactId>
    <version>1.68.0</version>
</dependency>

<dependency>
    <groupId>org.apache.jackrabbit</groupId>
    <artifactId>oak-jcr</artifactId>
    <version>1.68.0</version>
</dependency>

<dependency>
    <groupId>org.apache.jackrabbit</groupId>
    <artifactId>oak-store-document</artifactId>
    <version>1.68.0</version>
</dependency>

<!-- 使用兼容的MongoDB驱动版本 -->
<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>mongodb-driver-sync</artifactId>
    <version>4.6.1</version>
</dependency>

2. 使用MongoDB 4.x+驱动的API初始化DocumentNodeStore #

替换文档中过时的setMongoDB方法，改用支持新驱动API的构建方式：

import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoClient;
import org.apache.jackrabbit.oak.plugins.document.DocumentNodeStore;
import org.apache.jackrabbit.oak.plugins.document.mongo.MongoDocumentNodeStoreBuilder;

// 初始化MongoClient（4.x+ API）
MongoClient mongoClient = MongoClients.create("mongodb://localhost:27017");

// 构建DocumentNodeStore
DocumentNodeStore store = MongoDocumentNodeStoreBuilder.newMongoDocumentNodeStoreBuilder()
        .setMongoClient(mongoClient)
        .setDBName("oak")
        .build();

3. 解决ClassNotFoundException #

如果仍出现com.mongodb.operation.ReadOperation错误，需确保依赖中包含mongodb-driver-core和bson（通常mongodb-driver-sync会自动引入，但如果有依赖冲突需显式声明）：

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>mongodb-driver-core</artifactId>
    <version>4.6.1</version>
</dependency>
<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>bson</artifactId>
    <version>4.6.1</version>
</dependency>

总结 #

这并非官方bug，而是文档更新不及时和版本兼容性匹配错误导致的问题。只要按照Oak版本选择对应兼容的MongoDB驱动版本，并使用新驱动的API初始化，即可解决问题。

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