Grails 6项目遇CollectionCodecProvider类缺失，bson依赖被降级

核心问题根源 #

Grails 6.x的grails-mongodb插件默认依赖的MongoDB驱动版本链存在传递依赖冲突，直接导致BSON版本被拉低。具体来说，Grails 6.1.2的grails-datastore-mongodb模块硬指定依赖org.mongodb:mongodb-driver-sync:4.6.1，而该驱动又依赖org.mongodb:bson:4.6.1——你在Grails 5中使用的4.11.x版本BSON新增的CollectionCodecProvider类，在4.6.x版本中并不存在，因此触发类找不到的错误。

全新项目为何也出现问题？ #

Grails官方提供的mongodb特性模板，依赖配置未显式锁定BSON高版本，完全依赖插件传递的版本。当创建带mongodb特性的项目时，构建工具（Gradle/Maven）会遵循依赖解析规则，优先选择传递链中路径最短或最先声明的版本（此处为4.6.1），而非你预期的高版本。

依赖降级的核心机制（以Gradle为例） #

构建工具的依赖解析逻辑是版本降级的关键：

• 路径优先级：多个依赖路径指向同一库的不同版本时，优先选择路径更短的版本；
• 显式指定优先：核心插件（如Grails datastore模块）明确指定的依赖版本，会被优先采用，除非手动覆盖。

在Grails 6的grails-datastore-mongodb中，其依赖配置硬指定了mongodb-driver-sync:4.6.1，该驱动的BSON依赖版本也随之被固定，即使项目中曾声明4.11.x版本的BSON，构建工具也会因核心插件的路径优先级选择4.6.1。

验证冲突的方法 #

通过构建工具的依赖分析命令可追溯版本来源：

• Gradle：运行 ./gradlew dependencies --configuration runtimeClasspath | grep bson，查看BSON依赖的传递路径；
• Maven：运行 mvn dependency:tree -Dincludes=org.mongodb:bson，明确版本的依赖源头。

长期解决方案（替代手动添加依赖） #

不想每次手动指定版本的话，可通过版本锁定统一依赖：

• Gradle：在build.gradle中添加dependencyManagement块强制指定版本：

  dependencyManagement {
      dependencies {
          dependency 'org.mongodb:bson:4.11.1'
          dependency 'org.mongodb:mongodb-driver-sync:4.11.1'
      }
  }
  

• Maven：在pom.xml的<dependencyManagement>中锁定版本：

  <dependencyManagement>
      <dependencies>
          <dependency>
              <groupId>org.mongodb</groupId>
              <artifactId>bson</artifactId>
              <version>4.11.1</version>
          </dependency>
          <dependency>
              <groupId>org.mongodb</groupId>
              <artifactId>mongodb-driver-sync</artifactId>
              <version>4.11.1</version>
          </dependency>
      </dependencies>
  </dependencyManagement>
  

这种方式能确保项目中MongoDB相关依赖统一使用指定高版本，避免传递依赖导致的降级。

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