Mill构建工具升级至0.12.6/0.12.7版本时出现StackOverflowError问题分析

问题背景

在Mill构建工具从0.12.5版本升级到0.12.6或0.12.7版本时，部分用户遇到了构建过程中出现StackOverflowError的问题。该问题主要出现在使用ScalablyTyped插件（用于从TypeScript类型定义生成Scala类型定义）的项目中。

问题现象

当用户执行构建命令（如./mill __.compile）时，构建过程会在处理ScalablyTyped模块时陷入无限递归，最终导致栈溢出。从错误堆栈中可以观察到，问题主要发生在以下环节：

1. 模块依赖解析过程中
2. 内部仓库配置任务执行时
3. Coursier项目构建阶段

错误堆栈显示调用链在以下方法间循环：

• transitiveCoursierProjects
• internalDependenciesRepository
• repositoriesTask
• scalablytypedWorkerClasspath

技术分析

根本原因

经过分析，这个问题源于Mill 0.12.6/0.12.7版本中引入的依赖解析逻辑变更。具体表现为：

1. 循环依赖检测失效：新版本中模块间的依赖关系检测逻辑存在缺陷，导致在某些特定配置下无法正确识别循环依赖。

2. ScalablyTyped插件交互问题：该插件在定义自己的worker类路径时，与Mill核心的依赖解析机制产生了不预期的交互。

3. 缓存机制影响：Mill的缓存系统在处理这种特殊场景时未能正确中断递归调用。

典型触发场景

该问题通常在以下项目结构中触发：

1. 使用ScalablyTyped插件处理前端代码
2. 项目包含跨平台模块（JVM和JS共享代码）
3. 自定义了仓库配置（如添加私有Maven仓库）

解决方案

临时解决方案

对于遇到此问题的用户，可以采取以下临时措施：

1. 暂时回退到Mill 0.12.5版本
2. 在构建脚本中简化ScalablyTyped模块的依赖关系
3. 增加JVM栈大小（虽然不能根本解决问题，但可能帮助诊断）

长期解决方案

Mill开发团队已经意识到这个问题，并在后续版本中进行了修复。建议用户：

1. 关注Mill的更新公告
2. 在升级前测试新版本是否解决了该问题
3. 考虑重构构建脚本，减少模块间的复杂依赖

最佳实践建议

为了避免类似问题，建议在Mill项目中使用ScalablyTyped插件时：

1. 模块设计：保持ScalablyTyped模块的独立性，尽量减少与其他模块的交叉依赖

2. 版本控制：在升级构建工具版本时，先在测试环境中验证构建过程

3. 错误诊断：遇到类似问题时，可以通过简化构建脚本逐步定位问题模块

4. 依赖管理：合理组织ivyDeps和moduleDeps，避免复杂的传递依赖

总结

Mill构建工具作为Scala生态中的重要组成部分，其版本升级可能会带来一些兼容性问题。本次StackOverflowError问题提醒我们，在使用复杂插件和跨平台构建时需要特别注意依赖管理。通过理解问题本质和采取适当的预防措施，开发者可以更顺利地完成构建工具的升级和迁移。

对于依赖ScalablyTyped插件的项目，建议在升级前充分测试，或等待确认问题修复的稳定版本发布后再进行升级。