Gradle 8.2.0用TOML配置openapi-generator-gradle-plugin遇依赖缺失问题

DevOps 小满

2026-6-12

问题：Gradle 8.2.0 采用TOML集中配置openapi-generator插件无法找到依赖

我正在使用Gradle 8.2.0和openapi-generator-gradle-plugin 7.2.0，旧格式配置可正常运行：

buildscript {
    repositories {
        mavenLocal()
        mavenCentral()
        gradlePluginPortal()
    }

    dependencies {
        classpath group: "org.openapitools", name: "openapi-generator-gradle-plugin", version: "${openApiToolsVersion}"
    }
}

apply plugin: 'org.openapi.generator'

但改用现代化集中式TOML配置时无法找到对应依赖，我的gradle/libs.versions.toml内容如下：

[versions]
openapi-tools = "7.2.0"

[plugins]
openapi-generator = { id = "org.openapi.generator", version.ref = "openapi-tools" }

build.gradle中的引用方式：

plugins {
    alias(libs.plugins.openapi.generator)    
}

请问遗漏了什么步骤？

解决方案

问题核心在于插件ID的正确性以及TOML配置的规范，以下是修正步骤：

确认TOML文件的位置与命名
确保配置文件放在项目根目录下的gradle/libs.versions.toml，这是Gradle版本目录功能的默认路径，位置或名称错误会导致配置无法被识别。
修正插件ID
旧配置中使用的org.openapi.generator是插件的逻辑别名，但Gradle插件门户的正式注册ID为org.openapitools.openapi-generator。修改gradle/libs.versions.toml：
```
[versions]
openapi-tools = "7.2.0"

[plugins]
openapi-generator = { id = "org.openapitools.openapi-generator", version.ref = "openapi-tools" }
```
同步Gradle并刷新依赖
在IDE中执行Gradle同步操作，或在终端运行./gradlew clean build --refresh-dependencies，让Gradle重新加载配置并拉取正确的插件依赖。