Minecraft 1.7.10 Forge开发环境运行gradlew.bat报501错误求解
Minecraft 1.7.10 Forge开发501构建错误解决方案
错误根因
所有报错的核心原因是:Maven中央仓库已全面终止HTTP协议访问,所有走
http://repo1.maven.org/maven2/路径的依赖请求都会被返回501状态码,强制要求使用HTTPS协议访问。最初遇到的Eclipse Equinox系列依赖解析失败、调整配置后遇到的lzma-java下载失败,本质都是ForgeGradle 1.2 SNAPSHOT这个老版本插件硬编码了HTTP的仓库地址,没有适配现在仓库的HTTPS访问规则。
具体修复步骤
1. 重写build.gradle中的仓库配置
替换原有buildscript块里的仓库声明,把所有HTTP开头的仓库地址全部替换为HTTPS版本,同时补全老插件需要的兼容仓库:
buildscript { repositories { // 手动指定HTTPS版Maven中央仓库,替代默认的mavenCentral() maven { url = "https://repo1.maven.org/maven2/" } maven { name = "forge" // 替换原HTTP版Forge官方仓库地址 url = "https://files.minecraftforge.net/maven" } maven { name = "sonatype" url = "https://oss.sonatype.org/content/repositories/snapshots/" } // 补全lzma-java等老依赖所在的JCenter仓库 maven { url = "https://repo.jfrog.org/artifactory/jcenter/" } } dependencies { classpath 'net.minecraftforge.gradle:ForgeGradle:1.2-SNAPSHOT' } } // 其余原有配置保持不变:apply plugin、minecraft块、processResources块都不用修改
2. 清理旧的失败构建缓存
之前多次构建失败已经在本地留存了带错误HTTP路径的缓存记录,不清理的话改完配置依然会命中旧的错误请求逻辑:
- 删除项目根目录下的
.gradle隐藏文件夹 - 删除用户目录下的
C:\Users\你的用户名\.gradle\caches\modules-2文件夹
3. 补全Gradle全局兼容配置
ForgeGradle 1.2配套的Gradle 2.x版本默认不支持高版本TLS协议,会和现在的HTTPS仓库握手失败。在项目根目录新建gradle.properties文件,写入以下配置:
# 适配现代仓库的TLS协议版本 systemProp.https.protocols=TLSv1.2,TLSv1.3 # 调整Gradle运行内存,避免大文件下载时OOM org.gradle.jvmargs=-Xmx1024M -Dfile.encoding=UTF-8
4. 强制重新拉取依赖执行构建
配置修改完成后,在项目根目录打开命令提示符,执行带参数的构建命令,强制Gradle跳过所有旧缓存重新校验、拉取依赖:gradlew --refresh-dependencies build
避坑提醒
- 1.7.10版本的ForgeGradle 1.2插件仅兼容JDK 8,使用JDK 11及以上版本会直接触发反射访问权限报错,不要尝试适配高版本JDK
- 不要随意升级Gradle wrapper版本,保持Forge源码包自带的Gradle 2.0版本即可,高版本Gradle会完全移除对老插件的兼容支持
内容的提问来源于stack exchange,提问作者BeenJee
相关产品推荐
相关产品推荐

