Grails Gradle构建中添加Micronaut依赖报错的解决方法

你遇到的依赖解析错误核心原因是没有为Micronaut依赖指定对应版本，也没有导入Micronaut官方的BOM（物料清单）做统一版本管理，Gradle解析依赖时拿到的版本号为空，自然无法从仓库找到对应包，和是否配置mavenCentral()没有直接关系。

• 第一步：确认仓库配置
  确保build.gradle的repositories块包含主流公共仓库，稳定版Micronaut包全部托管在Maven Central，不需要额外加第三方仓库：

  repositories {
      mavenLocal()
      mavenCentral()
  }
  

• 第二步：添加Micronaut BOM版本管控
  Grails项目默认集成了io.spring.dependency-management插件，直接在构建文件中添加dependencyManagement块导入对应版本的Micronaut BOM即可，不需要给每个Micronaut依赖单独写版本号。注意版本匹配规则：Grails 5.x/6.x 兼容 Micronaut 3.x 系列，Grails 7.x 兼容 Micronaut 4.x 系列，跨大版本会出现类冲突。

  // 放在build.gradle和repositories平级的位置
  dependencyManagement {
      imports {
          // 示例用3.10.1为Micronaut 3.x稳定版，可根据自己的Grails版本替换
          mavenBom "io.micronaut:micronaut-bom:3.10.1"
      }
  }
  

• 第三步：放开你注释的Micronaut依赖
  直接在dependencies块中添加需要的依赖即可，不需要指定版本：

  dependencies {
      // 其他原有Grails依赖保留
      implementation("io.micronaut.reactor:micronaut-reactor")
      implementation("io.micronaut.reactor:micronaut-reactor-http-client")
      implementation("io.micronaut.security:micronaut-security-jwt")
      implementation("io.micronaut.views:micronaut-views-velocity")
      compileOnly("io.micronaut.security:micronaut-security-annotations")
  }
  

• 第四步：刷新依赖缓存
  配置完成后在项目根目录执行以下命令，清除之前的错误依赖缓存重新构建：

  ./gradlew clean build --refresh-dependencies
  

如果你的项目没有使用io.spring.dependency-management插件，也可以直接用Gradle原生的platform方式导入BOM，在dependencies块最顶部加一行即可：

dependencies {
    implementation platform("io.micronaut:micronaut-bom:3.10.1")
    // 其余依赖和之前一致
}

不要手动给单个Micronaut依赖指定版本，很容易出现同框架下不同包版本不一致的类冲突问题。

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