--test_env及--test_arg传参对Bazel测试缓存的影响咨询

通过--test_env、--test_arg传入每次变动的测试元数据，一定会干扰Bazel测试缓存的正常命中逻辑——这不是缓存异常，是Bazel缓存校验规则触发的正常结果，只要你传的可变值被纳入测试Action的缓存键计算范围，哪怕测试代码、依赖、输入文件完全没改动，Bazel也不会命中缓存，会重新执行测试。

• 用--test_arg传可变值的场景：Bazel计算测试Action缓存键时，会把测试进程的所有启动命令行参数完整纳入输入校验。只要你每次传入的参数值有变化（比如带了时间戳、流水线ID、随机TraceID这类每次执行都不一样的元数据），缓存键就会直接改变，必然打不中缓存。
• 用--test_env传可变值的场景：影响分两种情况：
  • 如果你传入的环境变量没有在对应py_test目标的env属性中声明为测试依赖，默认不会被纳入缓存键计算，这种情况下可变值不会破坏缓存，但存在被Bazel沙箱机制过滤、测试进程读不到变量的风险，稳定性很差。
  • 如果你已经在规则中声明了测试依赖该环境变量，或是所用的Bazel版本默认将命令行传入的--test_env变量纳入测试输入校验，那可变环境变量对缓存的影响和可变--test_arg完全一致，值变就会导致缓存失效。

核心原则是：绝对不要让可变元数据流入测试Action的输入校验范围，也不要让可变内容出现在测试的声明输出文件里，常用做法有两个：

1. 把可变元数据的注入逻辑放到测试执行的后置流程里：先正常跑bazel test拿到固定的测试结果产物，再在测试执行完成后的独立脚本里，把需要的可变元数据拼到结果里再上传到云端，全程不把可变值传给测试进程本身，完全不碰缓存校验逻辑。
2. 如果必须在测试进程运行时拿到元数据，就不要通过启动参数、声明依赖的环境变量传值：可以提前把可变元数据写到沙箱外的固定路径文件，测试代码运行时主动读取该路径的内容；注意测试拿到元数据后，不要把可变内容写到test.xml、test.log这类Bazel会校验哈希的声明输出文件里，要写就写到TEST_UNDECLARED_OUTPUTS_DIR指向的非声明输出目录下，这类目录下的文件不会被纳入缓存输出校验。

踩坑提醒：不要觉得可变元数据只是加在结果里不影响测试逻辑就不会碰缓存——Bazel的缓存校验是对Action所有输入、声明输出的全量哈希校验，只要参与计算的内容变了，不管是不是影响测试逻辑，都会直接判定缓存不匹配。

内容的提问来源于stack exchange，提问作者jxramos