Bazel项目测试执行平台选择机制的改进与迁移指南

在Bazel构建系统中，测试执行平台的选择机制长期以来存在一个潜在问题：测试动作默认会在第一个注册的执行平台上运行，而不考虑目标平台的约束条件。这在跨平台构建场景中经常导致运行时错误，例如"exec format"等格式不兼容问题。

问题背景

传统实现中，Bazel没有为测试执行组（test exec group）定义任何工具链要求。测试执行组是隐式定义的执行组，负责执行测试动作。由于缺乏明确的平台约束，系统会简单地选择第一个可用的执行平台，这可能与目标平台完全不兼容。

解决方案

Bazel引入了一个核心改进：所有未显式定义test执行组的测试规则现在都必须满足一个强制性的工具链要求。具体来说，这些规则需要依赖@bazel_tools//tools/test:default_test_toolchain_type工具链类型。

通过启用incompatible_use_default_test_toolchain标志，系统会注册一个默认工具链，该工具链会匹配所有满足目标平台约束的执行平台。这确保了测试会在与构建目标兼容的平台上执行。

迁移路径

对于大多数项目，这一变更不需要任何迁移操作，因为原先可能导致运行时失败的情况现在会在分析阶段就被捕获。

需要特别注意的情况包括：

1. 如果项目之前使用use_target_platform_for_tests标志，应该移除该标志的所有使用，并确保目标平台也被注册为执行平台。这可以通过MODULE.bazel文件中的register_execution_platforms或命令行参数extra_execution_platforms实现。

2. 对于维护能够在不符合所有目标平台约束的平台上运行的测试规则（例如可在任何Unix平台上运行的shell测试），需要显式定义test执行组来覆盖默认行为。可以通过添加强制性工具链要求并注册相应的工具链来实现。

技术实现细节

这一改进的核心在于工具链选择机制的增强。工具链选择是Bazel确定执行平台的基础机制。通过为测试执行组引入明确的工具链要求，系统能够更智能地选择兼容的执行平台。

默认工具链的注册行为会根据标志状态有所不同：

• 启用标志时：工具链会匹配满足目标平台所有约束的执行平台
• 禁用标志时：工具链不要求任何约束，保留选择第一个注册执行平台的旧有行为

最佳实践建议

对于项目维护者，建议：

1. 尽早启用这一标志以发现潜在的平台兼容性问题
2. 对于特殊测试用例，考虑显式定义执行组和工具链要求
3. 在跨平台构建场景中，确保执行平台的正确注册和配置

这一改进将在Bazel 9 LTS版本中默认启用，为构建系统的跨平台测试提供了更可靠的基础设施。