MinecraftForge 1.20.4版本中Groovy构建问题的技术分析

问题背景

在MinecraftForge 1.20.4版本中，开发团队为了遵循JPMS(Java平台模块系统)规范，对构建系统进行了调整。JPMS要求整个模块必须位于单一路径下，这导致Forge团队移除了原有的MOD_CLASSES系统，转而采用合并源代码集(sourcesets)的方案。

问题表现

当开发者尝试在1.20.4版本的Forge项目中使用Groovy语言进行模组开发时，构建过程会失败。具体表现为Gradle在任务依赖关系检测中发现潜在问题：compileGroovy任务使用了processResources任务的输出，但没有明确声明依赖关系。

技术根源

1. JPMS规范要求：Java模块系统需要所有模块内容位于单一目录结构下，这迫使Forge团队重新设计构建流程。

2. Gradle任务依赖：Gradle对任务输出重叠有严格限制，当多个任务操作同一输出位置时，必须明确声明依赖关系。

3. 语言插件冲突：Groovy插件等第三方语言支持插件通常有自己的源代码处理逻辑，与Forge的源代码集合并方案产生冲突。

解决方案

1. 临时解决方案：开发者可以使用Forge提供的bootstrap-dev库，它恢复了旧版的手动指定源代码集方式，并在运行时将它们合并。

2. 长期建议：

   • 对于特殊构建需求(如多语言支持)，建议开发专属Gradle插件处理
   • 考虑在开发环境使用不同的类加载策略，如基于JAR文件的类路径而非源代码集输出
   • 对于CI环境，可以禁用源代码集合并

3. 最佳实践：

   • 纯Java项目使用当前方案没有问题
   • 多语言项目应考虑使用专门的构建插件
   • 开发环境与生产环境可以采用不同的构建策略

技术影响

这一变更主要影响以下几类开发者：

1. 使用Groovy等非JavaJVM语言的模组开发者
2. 实现多平台支持的模组开发者
3. 使用IntelliJIDEA等严格遵循Gradle模型的IDE用户

结论

MinecraftForge团队在1.20.4版本中的构建系统变更是为了更好支持JPMS规范，虽然对标准Java开发没有影响，但确实给一些特殊构建场景带来了挑战。开发者应根据自身项目特点选择合适的解决方案，对于复杂项目建议开发定制化的构建插件来处理特殊需求。