Gradle插件从2.1.2升级到3.1.0后构建报错：无法创建android-lint变体

我之前帮不少开发者踩过Gradle升级的坑，你遇到的这个错误是因为Gradle 3.x版本对变体（variant）的处理逻辑做了严格调整，尤其是配置解析的时机限制更明确了。下面是几个经过验证的解决办法，你可以按顺序尝试：

1. 同步升级所有配套插件与Gradle版本 #

Gradle插件3.x对依赖的插件版本兼容性要求很高，旧版本的第三方插件很容易触发配置冲突：

• 先确认com.android.tools.build:gradle版本和Gradle wrapper版本匹配：3.1.x系列插件对应Gradle 4.4到4.7版本，你当前用的3.1.1插件可以把gradle/wrapper/gradle-wrapper.properties里的distributionUrl改成https\://services.gradle.org/distributions/gradle-4.4-all.zip
• 如果你项目里用了Fabric，把io.fabric.tools:gradle升级到1.26.1及以上版本，这个版本完全兼容Gradle 3.x
• 检查其他第三方插件（比如ButterKnife、Dagger、Retrofit的Gradle插件），确保它们的版本明确支持Android Gradle Plugin 3.x

2. 调整Lint任务的执行时机 #

这个错误本质是Lint变体的创建时机和配置解析时机冲突了，你可以在模块的build.gradle里添加以下配置，让Lint延迟到配置解析完成后再执行：

android {
    lintOptions {
        // 先临时关闭发布版本的lint检查，排查问题
        checkReleaseBuilds false
        // 如果有自定义lint规则文件，保留这行，没有可以删除
        lintConfig file("lint.xml")
    }
}

// 强制所有lint任务在assemble任务之后执行，避免配置阶段冲突
tasks.whenTaskAdded { task ->
    if (task.name.startsWith("lint")) {
        task.mustRunAfter 'assembleDebug', 'assembleRelease'
    }
}

3. 清理缓存并重新同步 #

旧的Gradle缓存经常会引发莫名其妙的冲突，执行以下步骤彻底清理：

• 打开Android Studio，点击File -> Invalidate Caches / Restart，选择Invalidate and Restart
• 手动删除项目根目录的.gradle文件夹、各个模块下的.gradle和build文件夹
• 重新打开项目，等待Gradle同步完成后，执行./gradlew clean build命令

4. 检查自定义Gradle逻辑的访问时机 #

如果你的项目里有自定义的Gradle任务或配置代码，比如直接在配置阶段访问了debugRuntimeElements这类配置，Gradle 3.x会禁止这种操作。你需要把这类代码移到任务的执行阶段：

// 错误示例（配置阶段直接访问配置）
def runtimeDeps = project.configurations.debugRuntimeElements.files

// 正确示例（移到doLast块，执行阶段访问）
task printRuntimeDependencies {
    doLast {
        def runtimeDeps = project.configurations.debugRuntimeElements.files
        println("Runtime dependencies: $runtimeDeps")
    }
}

如果以上方法都没解决问题，建议把Android Gradle Plugin升级到3.1.4——这是3.1.x系列的最终稳定版，修复了不少初期版本的bug，兼容性更好。

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