Gradle 8.0.2执行gradle init报错：wrapper任务配置异常

问题场景 #

• 已下载Gradle 8.0.2，目录结构为\gradle-8.0.2-bin\gradle-8.0.2\bin，目录下包含gradle和gradle.bat可执行文件
• 执行gradle init命令时构建失败，报错信息：

任务':wrapper'（类型为Wrapper）配置存在问题，插件'org.gradle.buildinit.plugins.BuildInitPlugin$Inject'中的'org.gradle.api.tasks.wrapper.Wrapper'类型属性'jarFile'不可写入，原因是目标路径的上级目录'C:\Users\baigk\Downloads\gradle-8.0.2-bin\gradle-8.0.2\bin\gradle'是文件而非目录，无法创建父目录，建议配置'jarFile'指向正确位置。

核心原因 #

默认情况下，Gradle的Wrapper任务会尝试将gradle-wrapper.jar放置在Gradle可执行文件所在目录的gradle子目录中，但该路径下的gradle是可执行文件而非目录，导致路径冲突，无法创建父目录存放jar包。

解决方案 #

1. 修改Wrapper任务配置 #

在生成的项目构建脚本中（build.gradle或build.gradle.kts），明确指定jarFile的路径到项目内部的专属目录：

• Groovy DSL（build.gradle）：

tasks.named('wrapper') {
    jarFile = file("gradle/wrapper/gradle-wrapper.jar")
}

• Kotlin DSL（build.gradle.kts）：

tasks.named<Wrapper>("wrapper") {
    jarFile = file("gradle/wrapper/gradle-wrapper.jar")
}

2. 手动创建目标目录（可选） #

如果项目根目录下没有gradle/wrapper目录，先通过命令创建：

mkdir gradle\wrapper

3. 重新执行构建 #

再次运行gradle init命令，即可完成项目初始化构建。

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