Android Studio项目同步失败：无法解析:app:debugRuntimeClasspathCopy配置的依赖

我之前也碰到过一模一样的问题，折腾了好一会儿才捋清楚，本质是Gradle的配置规则冲突——咱们一步步来解决：

错误核心原因 #

从报错信息里就能抓到关键：

Configurations should not act as both a resolution root and a variant simultaneously. Be sure to mark configurations meant for resolution as canBeConsumed=false or use the 'resolvable(String)' configuration factory method to create them.

简单说就是你定义的debugRuntimeClasspathCopy配置，被Gradle判定为同时扮演了两个矛盾的角色：既用来拉取/解析依赖，又用来被其他模块引用消费，这违反了Gradle的配置设计原则，所以同步直接失败了。

具体解决步骤 #

1. 找到配置定义的位置

打开app模块下的build.gradle（Groovy语法）或者build.gradle.kts（Kotlin语法），找到定义debugRuntimeClasspathCopy的代码块。通常会是类似这样的错误写法：

// Groovy 错误示例
configurations {
    debugRuntimeClasspathCopy
}

// Kotlin 错误示例
configurations {
    create("debugRuntimeClasspathCopy")
}

2. 修改配置，明确它的单一角色

我们需要告诉Gradle：这个配置只用来解析依赖，不能被其他模块消费，有两种推荐的修改方式：

方式一：显式标记配置属性

• Groovy DSL：

configurations {
    debugRuntimeClasspathCopy {
        canBeConsumed = false  // 禁止被其他模块引用消费
        canBeResolved = true   // 允许用来拉取解析依赖
    }
}

• Kotlin DSL：

configurations {
    create("debugRuntimeClasspathCopy") {
        isCanBeConsumed = false
        isCanBeResolved = true
    }
}

方式二：用Gradle官方推荐的resolvable工厂方法

这种写法更简洁，直接创建一个只能用来解析依赖的配置：

• Groovy DSL：

configurations {
    debugRuntimeClasspathCopy.resolvable()
}

• Kotlin DSL：

configurations {
    resolvable("debugRuntimeClasspathCopy")
}

3. 重新同步项目

改完之后，点击Android Studio右上角的「Sync Project with Gradle Files」按钮，或者在终端执行：

./gradlew clean :app:sync

一般到这一步同步就会成功了。

4. 额外排查（如果还是失败）

如果同步依然报错，可以试试这些方向：

• 执行./gradlew :app:assembleDebug --info，查看更详细的日志，定位有没有其他配置冲突
• 检查你引入的第三方插件，有些插件会自动生成这类配置，尝试更新插件到最新稳定版
• 升级Gradle到较新的稳定版本（比如7.6以上），旧版本可能存在配置校验的bug

内容来源于stack exchange