第3章：Gradle插件DSL变更导致构建失败

升级Compose Compiler后，Gradle同步或构建过程突然中断，终端输出大量Plugin not found、Cannot configure extension类错误。本章从现象入手，通过结构化排查表逐步定位新版Compiler插件DSL接口的签名变化，并解决plugin {} 块中apply false与alias的冲突问题。

3.1 现象识别

触发场景通常为同时启用了Compose Compiler Gradle Plugin与Kotlin Multiplatform或Android Gradle Plugin。典型错误日志如下：

Execution failed for task ':app:compileDebugKotlin'.
> Could not find method composeCompiler() for arguments [...] on extension of type org.jetbrains.kotlin.gradle.dsl.KotlinMultiplatformExtension.

或：

Plugin [id: 'org.jetbrains.compose', version: '1.7.10'] was not found in any of the following sources:
- Gradle Core Plugins (plugin is not in 'org.gradle' namespace)
- Plugin Repositories (could not resolve plugin artifact 'org.jetbrains.compose:org.jetbrains.compose.gradle.plugin:1.7.10')

3.2 数据采集

按照以下清单收集环境信息，为故障树分析提供输入：

pluginManagement { repositories { ... } }

plugins { id("org.jetbrains.compose") }

3.3 原因定位 —— 故障树分析

运用故障树从根事件“Compose插件构建失败”向下层层分解，定位到具体故障原因。下图展示了新版DSL变更导致的两个典型故障路径：路径A因apply false缺失；路径B因alias与apply false冲突。

故障树顶部三个分支中，DSL签名不匹配和apply false与alias冲突是本次升级最常见的原因。下表对比新旧DSL的差异：

3.4 修复动作

根据故障树定位到的具体原因，分别给出修复配置。

情形A：pluginManagement 中缺少 apply false

在settings.gradle.kts中显式声明：

pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
    plugins {
        id("org.jetbrains.compose") version "1.7.10" apply false
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories { google() mavenCentral() }
}

情形B：alias 与 apply false 冲突

如果使用版本目录（Version Catalog），确保libs.versions.toml中正确声明：

[plugins]
compose-compiler = { id = "org.jetbrains.compose", version = "1.7.10" }

然后在settings.gradle.kts中使用alias并配合apply false：

pluginManagement {
    plugins {
        alias(libs.plugins.compose.compiler) apply false
    }
}

情形C：模块级 build.gradle.kts 错误继承

在子模块中，直接应用插件（不写版本）：

plugins {
    id("org.jetbrains.compose")
    // 如果使用alias则可以：
    // alias(libs.plugins.compose.compiler)
}

注意不再需要apply false。若子模块同时使用apply plugin和plugins {}会导致重复注册。

3.5 复测与预防

修复后执行以下验证命令：

./gradlew clean assembleDebug --info 2>&1 | grep -i "compose"

确认无Plugin not found或apply false相关报错。建立团队级预防策略：

• 提交前检查清单：使用gradle --scan生成构建扫描，识别DSL兼容性警告。
• 统一模板脚本：在settings.gradle.kts中固定使用pluginManagement + apply false模式，避免开发者自行拼写。
• 版本目录规范化：确保libs.versions.toml中每个插件都有唯一别名，且与apply false配合测试。
• CI管道添加DSL校验：通过gradle wrapper --gradle-version锁定最小Gradle版本（建议≥8.5），并添加lint步骤扫描plugin {} 块。