Spring Data Reactive MongoDB+QueryDSL的MongoDB驱动版本冲突求助

问题根源在于querydsl-mongodb默认依赖的mongo-java-driver（3.12.8版本）与spring-boot-starter-data-mongodb-reactive引入的mongodb-driver-core（4.6.1版本）属于MongoDB驱动的新旧分支，3.x版本的mongo-java-driver是单体包，4.x版本拆分为mongodb-driver-core、mongodb-driver-sync等模块，二者API不兼容导致方法找不到。显式指定版本无效通常是因为未排除旧依赖，Maven仍会加载冲突的包。

以下是两种可行的pom.xml配置方案：

方案一：排除QueryDSL中的旧驱动依赖 #

直接排除querydsl-mongodb自带的旧版Mongo驱动，让项目自动使用Spring Boot管理的4.x版本驱动：

<dependencies>
    <!-- QueryDSL MongoDB依赖，排除旧版驱动 -->
    <dependency>
        <groupId>com.querydsl</groupId>
        <artifactId>querydsl-mongodb</artifactId>
        <version>${querydsl.version}</version>
        <exclusions>
            <exclusion>
                <groupId>org.mongodb</groupId>
                <artifactId>mongo-java-driver</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

    <!-- Spring Boot Reactive MongoDB Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-mongodb-reactive</artifactId>
    </dependency>
</dependencies>

方案二：通过依赖管理强制统一版本 #

如果需要指定特定兼容版本，可在dependencyManagement中声明统一的MongoDB驱动版本，同时排除QueryDSL的旧依赖：

<dependencyManagement>
    <dependencies>
        <!-- 统一MongoDB驱动版本，需与Spring Boot版本兼容 -->
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-core</artifactId>
            <version>${mongodb-driver.version}</version>
        </dependency>
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-sync</artifactId>
            <version>${mongodb-driver.version}</version>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>com.querydsl</groupId>
        <artifactId>querydsl-mongodb</artifactId>
        <version>${querydsl.version}</version>
        <exclusions>
            <exclusion>
                <groupId>org.mongodb</groupId>
                <artifactId>mongo-java-driver</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-mongodb-reactive</artifactId>
    </dependency>
</dependencies>

注意事项 #

• 确保QueryDSL版本与MongoDB驱动版本兼容：QueryDSL 5.x及以上版本支持MongoDB 4.x驱动；若使用旧版QueryDSL，需降级Spring Boot的Mongo驱动到3.x版本，但不推荐（Spring Boot官方starter的版本配对有兼容性保障）。
• 配置完成后执行mvn dependency:tree命令，确认依赖树中不再同时存在3.x和4.x的Mongo驱动包。

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