如何解决IntelliJ IDEA社区版导入Fabric示例Mod的Gradle构建错误

出现Caused by: org.codehaus.groovy.control.MultipleCompilationErrorsException: startup failed:的核心原因不是IDEA安装损坏：这是Gradle构建脚本启动阶段，Groovy编译器找不到适配运行环境抛出的错误，和项目JDK、Gradle版本的匹配关系直接相关，重装IDEA无法解决这类问题。

分步操作流程 #

• 核对项目源码匹配性
  • 确认从Fabric示例仓库拉取的源码和目标开发版本对应，跨版本随意切换分支下载的源码往往会出现构建脚本和本地环境不兼容的问题
  • 不要用浏览器下载zip包的方式获取源码，优先通过Git拉取完整仓库，避免压缩包解压导致的构建脚本文件缺失
• 修正Gradle和JDK的版本匹配关系
  • 打开项目根目录下gradle/wrapper/gradle-wrapper.properties文件，根据本地安装的JDK版本调整distributionUrl指向的Gradle版本：JDK17对应Gradle 7.6以上版本，JDK21对应Gradle 8.5以上版本，不要使用和JDK不兼容的过老Gradle版本
  • 打开IDEA「文件-项目结构」面板，将项目SDK设置为Fabric对应版本要求的正式JDK（比如MC 1.19-1.20.4版本用JDK17，MC1.20.5及以上版本用JDK21），不要把IDEA自带的JetBrains Runtime（JBR）当成项目编译用的JDK
• 清除残留缓存重新导入
  • 打开IDEA设置面板，选择「文件-管理IDE设置-清除缓存」，勾选清除文件系统缓存和本地历史，等待IDE自动重启
  • 重启IDE后重新选择「打开项目」导入源码，在弹出的Gradle关联配置窗口，手动选择提前安装好的正式JDK作为Gradle运行的JVM，不要选择默认的内置JBR
• 本地手动预校验构建环境
  • 打开项目根目录的系统终端，执行./gradlew --stop停掉所有残留的后台Gradle守护进程
  • 再执行./gradlew clean清理之前生成的无效构建缓存，看到执行成功的输出后，回到IDEA点击工具栏的「重新加载所有Gradle项目」按钮，等待构建完成

避坑提醒：导入项目时不要选择旧版Gradle导入模式，保持默认的Gradle导入流程即可；如果之前安装过旧版本的Fabric开发插件，先临时禁用，避免插件自带的旧构建逻辑和新版示例项目的脚本冲突。

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