如何解决build.gradle中'Unresolved reference: gradleEnterprise'问题？

问题根源 #

你当前的settings.gradle中，将com.gradle.enterprise插件的声明放在了pluginManagement块内部，这会导致插件无法在settings全局上下文生效，进而在build.gradle中找不到gradleEnterprise配置块的引用。

修复步骤 #

1. 调整settings.gradle的插件配置 #

将com.gradle.enterprise插件的声明从pluginManagement块中移出，放在文件的根级别。同时简化不必要的配置，最终的settings.gradle结构如下：

pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
        // 保留其他仓库配置
    }
}

// 在pluginManagement外部应用Gradle Enterprise插件
plugins {
    id("com.gradle.enterprise") version "3.6.3"
    // 其他全局插件声明
}

// 在这里配置Gradle Enterprise的全局设置（可选）
gradleEnterprise {
    buildScan {
        termsOfServiceUrl.set("https://gradle.com/terms-of-service")
        termsOfServiceAgree.set("yes")
    }
}

// 保留项目的其他settings配置，比如include(":app")等

2. （可选）统一配置位置 #

如果你更倾向于在build.gradle中配置build scan，确保settings.gradle已经正确应用插件后，build.gradle中的原配置可以保留。如果是多模块项目，建议在根build.gradle的allprojects或subprojects块中配置，保证所有模块生效。

3. 验证并同步 #

执行Gradle同步操作，检查报错是否消失。如果问题仍存在：

• 清理Gradle缓存，执行命令：./gradlew clean build --refresh-dependencies
• 确认使用的Gradle版本与com.gradle.enterprise插件版本兼容（3.6.3版本支持Gradle 5.4及以上）

关键说明 #

• pluginManagement块仅用于管理插件的依赖解析策略和仓库，不能在这里声明要应用的插件。
• Gradle Enterprise插件必须在settings.gradle的根级别应用，这样才能在settings和project上下文中生效，让gradleEnterprise配置块被识别。

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