修改Dockerfile后docker build未生效,Spring Boot镜像构建持续报旧路径错误
问题核心原因拆解
1. 多阶段构建存在语法缺失
- 你写的多阶段Dockerfile最基础的语法错误是:第二运行阶段的
COPY指令没有加--from=build参数 - Docker的COPY指令如果不手动指定来源,默认只会从本地构建上下文(即执行docker build命令的当前目录)查找文件,不会自动从前一个命名为
build的构建阶段的镜像层里取文件 - 你本来想从build阶段生成的镜像里拿解压好的依赖包,结果因为缺参数,Docker一直找本地路径下不存在的
target/dependency目录,自然报文件找不到的错。日志里出现的/workspace/app/target/dependency路径,本质是build阶段镜像内部的路径,因为语法错误被Docker错当成了本地要查找的路径。 - 你后来修改build阶段的WORKDIR为自定义路径、调整ARG的DEPENDENCY取值,都没解决问题的根本原因就在这里:因为COPY缺来源声明,Docker根本没有读取build阶段的任何路径配置,只是默认从本地找文件,你在build阶段改多少路径配置都不会影响第二阶段的COPY行为。
2. 修改Dockerfile不生效的本质
- 构建日志里的*
transferring context: 2B*是最关键的线索:这个数值代表传给Docker守护进程的构建上下文大小只有2字节,根本没把你本地修改的新Dockerfile传上去 - 常见的触发原因有两个:
- 项目根目录下的
.dockerignore配置错误,把Dockerfile本身以及所有项目文件都排除在构建上下文外,导致Docker一直用之前缓存的旧版Dockerfile内容执行构建,你本地怎么修改都传不到构建进程里 - 你执行
docker build命令的当前目录和存放修改后Dockerfile的目录不一致,Docker读到的是别的路径下的旧Dockerfile
- 项目根目录下的
- 这种情况下哪怕加
--no-cache参数,因为连正确的Dockerfile内容都没传进去,自然会一直报一模一样的旧错误。
修正后的可正常运行的Dockerfile
# 构建阶段 FROM amazoncorretto:11-alpine-jdk as build WORKDIR /workspace/app COPY mvnw . COPY .mvn .mvn COPY pom.xml . COPY src src RUN ./mvnw install -DskipTests RUN mkdir -p target/dependency && (cd target/dependency; jar -xf ../*.jar) # 运行阶段 FROM amazoncorretto:11-alpine-jdk RUN addgroup -S spring && adduser -S spring -G spring USER spring:spring # 核心修正:COPY指定从build阶段拷贝,同时用绝对路径避免工作目录匹配偏差 ARG DEPENDENCY=/workspace/app/target/dependency COPY --from=build ${DEPENDENCY}/BOOT-INF/lib /app/lib COPY --from=build ${DEPENDENCY}/META-INF /app/META-INF COPY --from=build ${DEPENDENCY}/BOOT-INF/classes /app ENTRYPOINT ["java","-cp","app:app/lib/*","com.helloyou.demo.DemoApplication"]
排错落地步骤
- 检查项目根目录的
.dockerignore文件,确保没有把Dockerfile、mvnw、.mvn、pom.xml、src这些需要参与构建的文件加入排除规则 - 执行构建前先跑
pwd命令确认当前工作目录,和存放项目文件的路径完全一致 - 构建时显式指定Dockerfile路径,执行
docker build -t myapp -f ./Dockerfile .,强制Docker读取当前目录下的最新Dockerfile - 如果BuildKit缓存有残留,先执行
docker builder prune -af清空所有构建缓存,再重新执行构建
内容的提问来源于stack exchange,提问作者Fernando Augusto
相关产品推荐
相关产品推荐

