MacOS中Docker构建未复用layer caches的原因咨询

以下是导致MacOS下Docker无法复用缓存层的几个核心原因：

• 文件系统元数据差异
  MacOS默认使用APFS/HFS+文件系统，Ubuntu则采用ext4等类Unix文件系统。Docker构建时会计算上下文文件的哈希值来校验缓存有效性，不同文件系统的文件元数据（如修改时间精度、权限位细节）存在差异——哪怕文件内容完全一致，两边计算出的哈希值也可能不同，导致Docker判定文件已变更，跳过缓存复用。

• Docker Desktop的虚拟化层干扰
  MacOS上的Docker Desktop运行在HyperKit虚拟机中，构建上下文需要从Mac宿主同步到虚拟机内的Docker环境。这个同步过程（依赖osxfs等文件共享机制）可能会重置文件修改时间、调整权限映射，导致文件属性与Linux宿主（Ubuntu）下的不一致，破坏了Docker的缓存校验逻辑。

• 路径与权限的环境差异
  Ubuntu上Docker直接运行在宿主系统，构建上下文的路径权限、用户组与Docker daemon环境完全匹配；而MacOS的Docker虚拟机内部用户环境与宿主不同，osxfs会自动转换文件权限，这会改变Docker计算文件哈希的依据，造成缓存不匹配。另外，MacOS文件路径大小写不敏感，Ubuntu则敏感，若上下文存在大小写模糊的文件，也会导致两边缓存判断逻辑出现偏差。

• Docker构建器或版本差异
  Ubuntu通过apt安装的Docker Engine与MacOS的Docker Desktop可能存在版本差，部分版本的缓存校验逻辑有细微区别。此外，Docker Desktop默认启用BuildKit构建器，而Ubuntu上可能默认使用传统构建器，两者的缓存策略存在差异。可以尝试在MacOS上用DOCKER_BUILDKIT=0 docker build ...切换到传统构建器，验证缓存是否能正常复用。

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