gradlew执行任务失败：无法解析:classpath配置文件

API 探路者

2026-7-10

解决命令行Gradle构建失败（Android Studio构建正常）的问题

问题概述

命令行执行./gradlew assembleRelease等Gradle任务时，出现依赖解析失败，报错信息显示无法匹配androidx.navigation:navigation-safe-args-gradle-plugin:2.7.3的变体，核心冲突是插件要求Java 17，但命令行构建环境被识别为Java 11。但相同任务在Android Studio中执行完全正常，且已尝试配置JVM工具链、对齐JAVA_HOME、清理Gradle缓存等操作，问题仍未解决。

解决方案

1. 确认命令行实际使用的JDK版本

虽然./gradlew --version显示JAVA_HOME指向JDK17，但系统PATH可能存在优先级更高的其他JDK。执行以下命令检查当前命令行环境的JDK版本：

java -version
javac -version

如果输出不是JDK17，临时调整PATH后再执行构建：

export PATH=/path/to/your/jdk17/bin:$PATH
./gradlew assembleRelease

也可以永久修改系统环境变量，将JDK17的bin目录放在PATH最前端。

2. 强制Gradle使用指定JDK

在项目根目录的gradle.properties文件中添加以下配置，强制Gradle构建时使用指定的JDK17，不受系统环境影响：

org.gradle.java.home=/path/to/your/jdk17

如果没有gradle.properties文件，直接创建即可。

3. 检查插件依赖的声明正确性

确认项目根目录的build.gradle（或build.gradle.kts）中，导航插件的依赖声明在buildscript块内，且仓库配置正确：

Groovy 示例：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:2.7.3"
    }
}

Kotlin DSL 示例：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath("androidx.navigation:navigation-safe-args-gradle-plugin:2.7.3")
    }
}

确保google()仓库优先，避免从其他仓库拉取不兼容的插件变体。