Docker环境Bazel配置本地磁盘远程缓存二次构建未提速咨询

现象是否符合预期 #

该现象不符合预期，你当前的配置存在几个典型误区，导致磁盘缓存没有被正确命中。

配置存在的核心问题 #

• 混淆了本地磁盘缓存和远程缓存的参数：你使用的--disk_cache是Bazel为单工作空间、单实例设计的本地缓存方案，它的缓存条目校验逻辑会绑定当前运行实例的输出基址信息，跨全新容器实例（输出基址完全重建）时，Bazel不会正常复用该路径下的旧缓存条目。
• 未固定动作环境哈希：默认配置下Bazel会将当前运行环境的大量非稳定参数计入动作缓存键，包括容器随机生成的HOSTNAME、默认PATH变量、运行用户UID/GID等，每次新建容器这些参数都会变化，直接导致所有缓存键不匹配。
• 未固定Bazel版本：你使用了bazel:latest镜像，若两次构建时镜像拉取到的Bazel版本存在差异（哪怕是小版本迭代），Bazel内置的规则、工具链默认配置的变化会导致所有缓存键失效。
• 潜在权限问题：若首次构建时容器以root用户写入缓存目录，第二次运行容器时如果使用非root用户，会出现无权限读取缓存目录的情况，Bazel会静默降级为无缓存模式，不会抛出显性错误。

修正方案 #

1. 替换缓存参数，将磁盘路径通过远程缓存协议挂载，替代原有的--disk_cache参数，该方式支持跨实例、跨容器共享缓存：

docker run --rm -it -v $PWD:/work -w /work bazel:6.4.0 \
  bazel build \
  --remote_cache=file:///work/.bazel-disk-cache \
  --incompatible_strict_action_env \
  //...

2. 固定Bazel镜像版本，不要使用latest标签，确保所有使用同一缓存的构建任务运行在完全一致的Bazel版本上。
3. 添加--incompatible_strict_action_env参数，屏蔽容器内非稳定环境变量对缓存键的影响，仅保留你显式通过--action_env传入的环境变量参与哈希计算。
4. 构建前校验缓存目录权限，确保容器内运行Bazel的用户对.bazel-disk-cache目录有完整读写权限。

缓存命中验证 #

重新执行首次构建生成缓存后，第二次运行构建时观察控制台输出：

• 缓存命中的动作前会标记[remote]标识，不会重新执行
• 若仍存在未命中的动作，可添加--explain=cache_miss.log --verbose_explanations参数构建，日志中会明确标注每个动作未命中缓存的具体原因（如输入文件变化、配置变化等）。

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