Bazel 8.0.0 编译失败问题分析与解决方案

Bazel 8.0.0 版本在编译过程中出现了一个较为严重的问题，导致无法完成自举编译（bootstrap build）。这个问题主要影响了使用 OpenJDK 21 的用户，在 Arch Linux 和其他 Linux 发行版上均有报告。

问题现象

当用户尝试使用 Bazel 官方推荐的自举编译方法时，会遭遇以下错误：

ERROR: /tmp/bazel_gzgyPZVJ/out/external/bazel_tools/tools/allowlists/function_transition_allowlist/BUILD: no such target '@@bazel_tools//tools/allowlists/function_transition_allowlist:function_transition_allowlist'

错误信息表明编译系统无法找到 function_transition_allowlist 这个目标，而这个目标是 java_runtime_version_alias 规则隐式依赖的必需组件。

问题根源

深入分析后发现，这个问题源于 Bazel 8.0.0 版本中关于功能转换（function transition）白名单机制的配置问题。具体来说：

1. 虽然 function_transition_allowlist 目标确实存在于 Bazel 源代码中（位于 tools/allowlists/function_transition_allowlist/BUILD.tools），但在编译过程中未能正确加载。

2. 这个问题特别影响了 rules_java 工具链中的相关规则，因为这些规则仍然保留了对该白名单的引用，尽管这些引用在新版本中实际上已经变得冗余。

3. 令人困惑的是，这个问题并未在 Bazel 的持续集成测试中被发现，表明测试覆盖存在盲区。

解决方案

Bazel 开发团队迅速响应并修复了这个问题：

1. 修复版本已经包含在 Bazel 8.0.1 RC1 中，用户可以测试这个候选发布版本来验证问题是否解决。

2. 对于使用 Bazelisk 的用户，可以通过设置 USE_BAZEL_VERSION=8.0.1rc1 来指向最新的修复版本。

3. 从用户反馈来看，Bazel 8.0.1 已经能够顺利完成编译过程，解决了这个自举编译问题。

技术背景

这个问题涉及到 Bazel 的几个核心概念：

1. 功能转换（Function Transition）：这是 Bazel 配置系统的一部分，允许规则在不同配置之间转换。

2. 白名单机制：Bazel 使用白名单来控制哪些规则可以使用特定的高级功能，这是一种安全机制。

3. 自举编译（Bootstrap Build）：即使用现有 Bazel 版本来编译新版本 Bazel 的过程，这是确保 Bazel 自我维持能力的关键测试。

最佳实践

对于遇到类似编译问题的用户，建议：

1. 始终使用官方推荐的 Java 版本（目前是 OpenJDK 11 或 17）进行编译，避免使用较新但未经充分测试的 Java 版本。

2. 在报告问题时，提供完整的错误日志和环境信息，包括操作系统版本和 Java 版本。

3. 关注 Bazel 的发布说明，特别是已知问题和修复的版本。

Bazel 团队表示将继续调查为何这个问题未能被 CI 测试捕获，以改进未来的测试覆盖率。对于开发者而言，这个问题也提醒我们在进行重大配置系统变更时需要更加全面的测试验证。