IntelliJ IDEA下使用Docker构建Spring Boot应用时构建耗时过长的优化方案咨询

我之前在Docker里搭建Spring Boot开发环境时也遇到过一模一样的问题——每次改一行代码都要等十几分钟重新下载依赖，简直崩溃！结合我的实践经验，给你几个针对性的解决方案：

一、利用Docker分层缓存，避免重复下载依赖 #

你的Dockerfile现在是直接把所有代码复制后就执行gradle build，这意味着只要代码有任何改动，Docker就会重新执行整个构建阶段，包括重新下载所有依赖。我们可以通过拆分依赖下载和代码编译的步骤来利用Docker的缓存机制：

修改你的构建阶段Dockerfile如下：

FROM gradle:7.4.2-jdk18-alpine AS build
# 第一步：先复制Gradle配置文件（build.gradle、settings.gradle）
COPY --chown=gradle:gradle build.gradle settings.gradle /home/gradle/src/
WORKDIR /home/gradle/src
# 提前下载所有依赖，这一步会被Docker缓存，只有配置文件改动时才会重新执行
RUN gradle build --no-daemon --debug --dry-run || true
# 第二步：再复制所有项目代码
COPY --chown=gradle:gradle ./ /home/gradle/src
# 执行实际构建（可以加上-x test跳过测试加快速度）
RUN gradle build --no-daemon --debug -x test

# 后续的运行阶段保持不变
FROM openjdk:19-slim
EXPOSE 5097
EXPOSE 5005
RUN mkdir /app
COPY --from=build /home/gradle/src/build/libs/*.jar /app/spring-boot-application.jar
ENTRYPOINT ["java", "-Xdebug", "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005", "-jar", "/app/spring-boot-application.jar"]

原理说明： #

Docker的镜像分层是从上到下缓存的，只要某一层的内容没有变化，Docker就会直接复用之前的缓存层。我们先复制依赖配置文件，执行gradle build --dry-run（这个命令会解析依赖并下载，但不会实际编译代码），这一层的缓存会被保留，只有当你修改build.gradle或settings.gradle时，才会重新下载依赖。之后再复制代码，即使代码改动，依赖层的缓存依然有效，大大缩短构建时间。

二、挂载本地Gradle缓存，进一步提速 #

除了Docker分层缓存，你还可以把本地电脑上已经下载好的Gradle依赖缓存挂载到容器里，让容器直接复用本地的依赖文件，彻底避免重复下载：

修改docker-compose.yml的volumes部分，加上本地Gradle缓存的挂载：

version: '3.7'
services:
  hmis-config-service:
    build:
      context: .
      dockerfile: Dockerfile
    image: 'hmis-config-service:0.0.0.1'
    ports:
      - "5097:5097"  # 注意这里要和Dockerfile里的EXPOSE端口对应，你之前写的9060:5080可能是笔误
      - "8091:5005"
    volumes:
      - ./:/home/gradle/src  # 挂载本地代码目录到容器，同步代码改动
      - ~/.gradle:/home/gradle/.gradle  # 挂载本地Gradle缓存到容器
    environment:
      db.url: 'jdbc:postgresql://host.docker.internal:5432/hms'
      db.username: 'postgres'
      db.password: 'pgsroot'
      GRADLE_HOME: /usr/local/gradle
      JAVA_HOME: /usr/lib/jvm/java
volumes:
  myapp:  # 这个命名卷可以去掉，因为我们直接挂载了本地目录

注意事项： #

• 如果你用的是Windows或Mac，~/.gradle的路径可能需要调整，比如Windows是C:\Users\<你的用户名>\.gradle
• 挂载本地代码目录后，你本地的代码改动会实时同步到容器里，但如果是用jar包运行的话，还是需要重新构建镜像才能生效——所以下面给你讲开发环境的优化方案。

三、开发环境用Gradle BootRun代替Jar包运行 #

对于开发阶段，我们完全不需要每次都构建Jar包，直接用gradle bootRun启动应用，这样代码改动后可以快速重载（结合Spring DevTools效果更好）：

1. 创建专门的开发Dockerfile（比如Dockerfile-dev） #

FROM gradle:7.4.2-jdk18-alpine
EXPOSE 5097
EXPOSE 5005
WORKDIR /home/gradle/src
# 复制代码（或者通过挂载同步，这里可以不用复制）
COPY --chown=gradle:gradle ./ .
# 用bootRun启动，同时开启远程调试
ENTRYPOINT ["gradle", "bootRun", "--no-daemon", "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005"]

2. 修改docker-compose.yml使用开发配置 #

version: '3.7'
services:
  hmis-config-service:
    build:
      context: .
      dockerfile: Dockerfile-dev
    image: 'hmis-config-service-dev:0.0.0.1'
    ports:
      - "5097:5097"
      - "5005:5005"
    volumes:
      - ./:/home/gradle/src
      - ~/.gradle:/home/gradle/.gradle
    environment:
      db.url: 'jdbc:postgresql://host.docker.internal:5432/hms'
      db.username: 'postgres'
      db.password: 'pgsroot'
      SPRING_PROFILES_ACTIVE: dev  # 启用开发环境配置

优点： #

• 代码改动后，Gradle会自动检测并重新编译（如果开启了Spring DevTools，甚至可以自动重启应用）
• 完全复用本地Gradle缓存，不需要重复下载依赖
• 启动速度比构建Jar包快很多

最后检查一个小问题 #

你Dockerfile里EXPOSE的是5097，但docker-compose里映射的是9060:5080，这两个端口不匹配，记得改成一致的，不然应用启动后可能无法访问。

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