从AWS迁移至GCP/GKE：Spring Boot依赖层Docker构建失败求助

一、核心问题解决：Maven找不到依赖 artifact #

你碰到的Could not find artifact com.dep:dependency-layer:jar:0.0.1-SNAPSHOT错误，本质是Maven构建test-app时，本地仓库或构建上下文里缺失这个依赖层jar包。手动安装后能正常运行，说明jar本身没问题，问题出在构建流程的自动化环节：

• 若依赖层是独立的Maven模块，必须确保构建test-app前，先执行依赖层模块的mvn clean install，将jar推送到本地Maven仓库；如果是多模块项目，直接在根目录执行mvn clean install，Maven会自动按依赖顺序完成构建。
• 若依赖层是非Maven项目，需要在test-app的Dockerfile中添加步骤，把依赖层jar复制到容器内Maven可识别的路径，比如构建阶段先COPY依赖层jar到~/.m2/repository/com/dep/dependency-layer/0.0.1-SNAPSHOT/目录，再执行mvn clean install。

二、依赖层是否需要Shade构建？ #

是否使用Shade插件分场景判断：

• 如果依赖层仅包含第三方依赖包（比如通用工具库、AWS SDK），且这些包和test-app的依赖无版本冲突，不需要Shade，直接打包成普通jar即可。
• 如果依赖层包含自定义代码，或者存在依赖版本冲突（比如test-app和依赖层用了不同版本的同一库），就需要用Shade插件将依赖层的所有依赖打成fat jar，同时通过relocate配置重命名冲突包的包名，避免运行时冲突。

三、GKE对分层构建的支持 #

GKE完全支持Docker分层构建，且这是官方推荐的优化方式——分层构建能大幅提升镜像构建速度和拉取效率：

• 将依赖层作为单独的镜像层，先构建包含所有共用依赖的基础镜像；test-app的镜像基于这个基础镜像构建，仅添加自身业务代码。这样每次业务代码变更时，只需重新构建上层业务层，依赖层可直接复用缓存。
• 示例多阶段+分层Dockerfile：

  # 阶段1：构建依赖层
  FROM maven:3.8.6-openjdk-11 as dependency-builder
  WORKDIR /app/dependency-layer
  COPY pom.xml .
  RUN mvn dependency:go-offline
  COPY src ./src
  RUN mvn clean package -DskipTests
  
  # 阶段2：构建test-app
  FROM maven:3.8.6-openjdk-11 as app-builder
  WORKDIR /app/test-app
  COPY pom.xml .
  RUN mvn dependency:go-offline
  # 从依赖层阶段复制jar到Maven本地仓库，解决依赖找不到的问题
  COPY --from=dependency-builder /app/dependency-layer/target/dependency-layer-0.0.1-SNAPSHOT.jar ~/.m2/repository/com/dep/dependency-layer/0.0.1-SNAPSHOT/
  COPY src ./src
  RUN mvn clean package -DskipTests
  
  # 阶段3：构建轻量运行镜像
  FROM openjdk:11-jre-slim
  WORKDIR /app
  COPY --from=app-builder /app/test-app/target/test-app-*.jar app.jar
  CMD ["java", "-jar", "app.jar"]
  

四、多阶段构建的额外优化点 #

多阶段构建不仅能解决依赖问题，还能缩小最终镜像体积：

• 拆分构建与运行阶段：把依赖下载、编译、打包放在带Maven的构建镜像中，最终运行镜像只保留JRE和业务jar，移除构建工具、源码等冗余内容，大幅减少镜像大小。
• 利用Docker缓存：将COPY pom.xml和RUN mvn dependency:go-offline放在COPY src之前，只有pom.xml变更时才会重新下载依赖，提升构建速度。
• 共用依赖层镜像：如果4个Spring Boot应用都依赖同一层，可将依赖层单独构建成镜像，每个应用的构建阶段直接基于该镜像拉取依赖，无需重复构建依赖层。

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