修改Dockerfile中FROM的PHP版本后容器未更新，为何无法自动生效？

初始Dockerfile内容：

FROM php:8.2-fpm-alpine

构建容器后执行php -v，显示版本为8.2.19。将Dockerfile中的PHP版本改为8.3，执行docker-compose build && docker-compose -p test up -d重新构建后，容器内执行php -v仍显示8.2.19，只有删除原有镜像后重新构建才能得到8.3版本。

使用的docker-compose.yml内容：

services:
    php:
        build:
            context: .
            dockerfile: Dockerfile
        container_name: php_version_test
        volumes:
            - ./:/var/www/html
        ports:
            - "9000:9000"

疑问：Docker通常能检测Dockerfile的变化，为什么这个场景下无法自动应用修改？

核心原因：Docker的缓存复用逻辑 #

Docker构建镜像时会优先复用本地已有的镜像层来提速，这里的问题出在两个点：

1. 基础镜像的缓存复用：当你把FROM指令从php:8.2-fpm-alpine改成php:8.3-fpm-alpine时，如果本地已经存在php:8.3-fpm-alpine镜像（比如之前误拉过），Docker会直接用本地的这个镜像，不会主动去远程仓库确认该标签是否对应了正确的新版本镜像。
2. 构建缓存的过度复用：由于你的Dockerfile只有FROM这一条指令，Docker可能判定“构建上下文没有实质变化”，直接复用了之前基于8.2版本构建的自定义镜像缓存，完全跳过了重新拉取基础镜像的步骤。

为什么删镜像就能解决？ #

当你删除本地的旧镜像（不管是官方的php:8.2-fpm-alpine还是自己构建的自定义镜像），Docker构建时没有任何缓存可以复用，只能重新从远程仓库拉取你指定的php:8.3-fpm-alpine镜像，从头构建自然就能得到正确的版本。

不用删镜像的解决方法 #

• 强制跳过所有缓存构建：执行docker-compose build --no-cache && docker-compose -p test up -d，让Docker忽略所有缓存，重新拉取基础镜像并构建。
• 先拉取最新基础镜像：先执行docker pull php:8.3-fpm-alpine确保本地的标签对应最新镜像，再执行原构建命令。
• 修改docker-compose.yml强制拉取：在build配置里加pull_policy: always，让Docker每次构建都主动拉取最新的基础镜像：

  services:
      php:
          build:
              context: .
              dockerfile: Dockerfile
              pull_policy: always
          container_name: php_version_test
          volumes:
              - ./:/var/www/html
          ports:
              - "9000:9000"
  

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