Mill项目脚本更新导致旧版本BSP支持中断问题分析

在Mill构建工具的最新开发中，我们发现了一个影响向后兼容性的重要问题。该问题源于近期对Mill启动脚本的修改，意外地破坏了旧版本Mill（包括当前稳定版0.12.10）的BSP（Build Server Protocol）功能支持。

问题本质

BSP作为构建工具与IDE之间通信的标准协议，在Mill中通过特定的系统属性mill.main.cli来实现连接配置。近期代码变更移除了脚本中对该属性的传递，导致生成的BSP/mill-bsp.json连接文件无效。这使得使用旧版Mill的用户无法通过BSP协议获得IDE集成支持。

技术背景

Mill的启动脚本设计有一个关键特性：它们需要作为通用启动器，能够兼容用户选择的任何Mill版本。这意味着脚本必须保持对已发布版本（特别是稳定版）所有功能的完整支持，即使这些功能在新开发版本中可能已被重构或弃用。

影响范围

这个问题特别值得注意，因为它影响了：

1. 当前广泛使用的稳定版本0.12.10
2. 所有依赖BSP功能进行IDE集成的开发工作流
3. 使用旧版Mill的现有项目

解决方案

修复方案相对直接：恢复脚本中对mill.main.cli系统属性的传递。虽然该属性在新版本中可能不再使用，但为了保持向后兼容性，必须在启动脚本中继续支持。

经验教训

这个案例给我们几个重要启示：

1. 在修改通用启动脚本时，必须考虑所有受支持版本的兼容性需求
2. 稳定版本的功能支持需要长期维护，不能仅基于开发分支的需求做决策
3. 自动化测试应该覆盖主要版本的特性兼容性

最佳实践建议

对于类似工具的开发维护，建议：

1. 建立明确的版本支持策略
2. 对脚本修改进行多版本测试
3. 维护重要的系统属性，即使在新版本中已弃用
4. 通过文档明确标注兼容性要求

这个问题现已通过提交修复，但提醒我们在基础设施工具开发中，向后兼容性始终是需要优先考虑的关键因素。