执行./gradlew genSources时构建失败（Fabric 1.20模组开发）

云上老周

2026-7-4

问题

跟随Kaupenjoe的1.20版本Fabric模组开发教程设置工作区时，执行./gradlew genSources命令构建失败，报错信息如下：

FAILURE: Build failed with an exception.
Where:
Build file '/Users/User/Desktop/Mods/Fabric-Tutorial-1.20.X/build.gradle' line: 2
What went wrong:
Error resolving plugin [id: 'fabric-loom', version: '1.4-SNAPSHOT']
Could not resolve all dependencies for configuration 'detachedConfiguration1'.
Cannot invoke "org.gradle.cache.FileLock.writeFile(java.lang.Runnable)" because the return value of "org.gradle.cache.internal.DefaultCacheCoordinator.access$300(org.gradle.cache.internal.DefaultCacheCoordinator)" is null
Try:
Run with --stacktrace option to get the stack trace.
Run with --info or --debug option to get more log output.
Run with --scan to get full insights.
Get more help at https://help.gradle.org.
BUILD FAILED in 519ms

已尝试更换Fabric Loom版本（操作可能有误），并重新核对教程步骤，仍无法解决，求帮助。

解决方案

清理Gradle缓存：删除Mac本地Gradle缓存目录~/.gradle/caches，之后重新执行./gradlew genSources。缓存损坏是这类空指针错误的常见诱因。
使用稳定版Fabric Loom：放弃1.4-SNAPSHOT快照版本，替换为与1.20.x兼容的稳定版（如1.3.2）。修改build.gradle顶部的插件配置：
```
plugins {
    id 'fabric-loom' version '1.3.2'
}
```
同时检查settings.gradle的仓库配置，确保包含Fabric官方仓库：
```
pluginManagement {
    repositories {
        maven { url 'https://maven.fabricmc.net/' }
        gradlePluginPortal()
        mavenCentral()
    }
}
```
匹配Gradle与Loom版本：如果项目Gradle版本和Loom不兼容也会触发问题。修改gradle/wrapper/gradle-wrapper.properties中的Gradle版本，比如使用与Loom 1.3.x兼容的8.2：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip
```
检查目录权限：确认项目目录/Users/User/Desktop/Mods/Fabric-Tutorial-1.20.X有读写权限，Mac下可通过右键文件夹→显示简介，设置当前用户的读写权限。