Forge 1.16.5编译Mod报错：Unable to get mutable Windows environment variable map

问题描述 #

编译自定义Minecraft模组时遇到以下错误：

Unable to get mutable Windows environment variable map

环境配置信息：

JDK 8.0;
Minecraft 1.16.5; 
Forge 20210309-1.16.5; 
IDEA: Intellij
Addons: Citadel; JEI;
Gradle: 4.10.3

已确认Windows环境变量配置正确。

解决方案 #

• 以管理员身份运行IDEA：Windows系统中，Gradle读取/修改可变环境变量映射需要管理员权限。关闭IDEA后右键选择「以管理员身份运行」，再重新执行编译操作。
• 命令行直接执行Gradle编译：打开管理员模式的命令提示符，进入项目根目录，运行gradlew clean build，排查是否是IDEA本身的配置问题。
• 清理Gradle缓存：删除项目根目录下的.gradle文件夹，以及用户目录（C:\Users\[你的用户名]\.gradle\caches）中的缓存文件，之后重新执行编译。
• 核对JDK与Gradle配置：确保JAVA_HOME指向JDK 8的完整路径，IDEA的「Project Structure」中SDK设置为JDK 8，「Settings」中Gradle路径配置正确。
• 禁用冗余IDEA插件：暂时禁用非必要的第三方插件（如与模组开发无关的工具类插件），避免插件干扰Gradle运行流程。

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