为何Docker会缓存echo date及echo date >> /timestamp.txt命令？

Docker的镜像构建缓存不会检查命令执行结果是否变化，它的判断逻辑是：

• 先看当前指令之前的所有构建层是否都命中缓存
• 再看这条指令的文本内容是否完全和之前一致
• 同时构建上下文里没有触发缓存失效的文件变更

只要满足这几点，Docker就会直接复用之前的缓存层，根本不会去执行命令验证结果。

比如你写的这两条命令：

RUN echo date
RUN echo date >> /timestamp.txt

每次构建时命令文本完全没变，哪怕date的输出随时间变化，Docker也会认为这两条指令不需要重新执行，直接用缓存。

哪怕你写了结果随机的命令（比如RUN echo $RANDOM），只要命令文本不变，Docker照样会缓存，因为它只认命令字符串，不管执行出来的结果是什么。

怎么让这类动态命令不被缓存？ #

如果确实需要让某条RUN指令每次构建都重新执行，有两种常用方法：

1. 全局禁用缓存（不推荐） #

构建时加上--no-cache参数：

docker build --no-cache .
# 或者用docker-compose
docker-compose build --no-cache

但这样会让整个构建过程都跳过缓存，所有层都重新构建，效率很低，只适合临时场景。

2. 给指令添加动态参数（推荐） #

通过构建参数（ARG）引入一个每次构建都会变化的值，让Docker认为这条指令的上下文变了，从而跳过缓存。

比如修改Dockerfile：

# 定义一个构建参数
ARG BUILD_SIGNAL
RUN echo $(date) >> /timestamp.txt
# 或者直接用参数触发缓存失效
RUN echo $BUILD_SIGNAL >> /timestamp.txt

然后构建时传递一个动态值（比如当前时间戳）：

# docker build
docker build --build-arg BUILD_SIGNAL=$(date +%s) .

# docker-compose的话，先设置环境变量再构建
BUILD_SIGNAL=$(date +%s) docker-compose build

这样每次构建时BUILD_SIGNAL的值都不同，Docker会认为这条RUN指令的依赖变了，就会重新执行，不会用缓存。

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