Docker Compose中Spring Boot+Gradle+PostgreSQL构建就绪性问题处理

我正在开发一个以PostgreSQL为数据库的Spring Boot练手项目，使用Docker Compose编排容器。当前遇到的问题是：Dockerfile中的RUN ./gradlew build命令在PostgreSQL容器完全启动就绪前就已执行，导致构建过程中测试失败。

Dockerfile #

# Build stage
FROM amazoncorretto:17 AS build
WORKDIR /app
COPY ../ /app
RUN ./gradlew build

# Runtime stage
FROM amazoncorretto:17 AS runtime
WORKDIR /app
COPY --from=build /app/build/libs/*.jar /app/app.jar
CMD ["java", "-jar", "/app/app.jar"]

docker-compose.yaml #

version: '3.8'

services:
  postgres:
    image: 'postgres:latest'
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    ports:
      - '5432:5432'
    healthcheck:
      test: pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}
      interval: 10s
      timeout: 5s
      retries: 5

  app:
    build:
      context: .
      dockerfile: docker/Dockerfile
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/${POSTGRES_DB}
      SPRING_DATASOURCE_USERNAME: ${POSTGRES_USER}
      SPRING_DATASOURCE_PASSWORD: ${POSTGRES_PASSWORD}
    ports:
      - '8080:8080'

我已尝试在docker-compose.yaml中使用depends_on和healthcheck配置，但问题仍未解决，现提出以下问题：

1. 如何确保PostgreSQL容器完全就绪后再执行./gradlew build命令？
2. 是否有更“Docker原生”或“Spring原生”的方式处理构建过程中的这种依赖关系？

问题1：确保PostgreSQL就绪后执行构建 #

你核心问题出在：Docker Compose的depends_on只控制容器启动顺序，管不到镜像构建阶段的命令。RUN ./gradlew build是在构建镜像时跑的，这个过程早于容器启动，所以depends_on对它完全没用。

这里给两个可行方案：

方案1：临时应急——把构建移到容器启动阶段（不推荐长期用） #

修改Dockerfile，把构建命令放到容器启动时执行，这样就能利用depends_on等PostgreSQL就绪：

FROM amazoncorretto:17
WORKDIR /app
COPY ../ /app
# 启动时先构建再运行
CMD ./gradlew build && java -jar build/libs/*.jar

缺点很明显：每次启动容器都要重新构建，效率极低，只适合临时测试。

方案2：正式解决——构建阶段加等待脚本 #

在Dockerfile的构建阶段加入等待PostgreSQL就绪的脚本，再执行构建：

1. 项目根目录创建wait-for-postgres.sh脚本：

#!/bin/bash
set -e

host="$1"
shift
cmd="$@"

until pg_isready -h "$host" -U "$POSTGRES_USER" -d "$POSTGRES_DB"; do
  >&2 echo "PostgreSQL还没好 - 再等2秒"
  sleep 2
done

>&2 echo "PostgreSQL就绪了 - 执行构建"
exec $cmd

给脚本加执行权限：chmod +x wait-for-postgres.sh

2. 修改Dockerfile构建阶段，安装postgresql-client（需要pg_isready命令），并使用脚本等待：

# Build stage
FROM amazoncorretto:17 AS build
WORKDIR /app
# 安装PostgreSQL客户端工具
RUN yum install -y postgresql && yum clean all
COPY ../ /app
# 传递环境变量，等待数据库就绪后执行构建
ENV POSTGRES_USER=${POSTGRES_USER}
ENV POSTGRES_DB=${POSTGRES_DB}
RUN ./wait-for-postgres.sh postgres ./gradlew build

# Runtime stage
FROM amazoncorretto:17 AS runtime
WORKDIR /app
COPY --from=build /app/build/libs/*.jar /app/app.jar
CMD ["java", "-jar", "/app/app.jar"]

3. 修改docker-compose.yaml，构建时传递环境变量：

app:
  build:
    context: .
    dockerfile: docker/Dockerfile
    args:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_DB: ${POSTGRES_DB}
  # 其他配置保持不变

这样构建镜像时，脚本会自动等PostgreSQL容器就绪后再跑构建命令。

问题2：Docker原生/Spring原生解决方案 #

Docker原生：分离单元测试与集成测试 #

更合理的做法是构建阶段只跑单元测试，跳过需要数据库的集成测试，集成测试放到容器启动后或者CI/CD流程里单独处理。

修改Dockerfile的构建命令：

RUN ./gradlew build -x test

这样构建时不会执行依赖数据库的测试，镜像构建完成后，你可以通过docker exec手动跑集成测试，或者在CI流程中单独配置测试环节。

Spring原生：用Testcontainers管理测试数据库 #

Spring官方推荐用Testcontainers处理集成测试的数据库依赖——它会在测试时自动启动一个临时的PostgreSQL容器，完全不需要依赖外部的Docker Compose容器。

步骤如下：

1. 在build.gradle中添加Testcontainers依赖：

testImplementation 'org.testcontainers:junit-jupiter'
testImplementation 'org.testcontainers:postgresql'

2. 修改测试类，让Testcontainers自动创建测试用数据库：

import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import org.testcontainers.containers.PostgreSQLContainer;
import org.testcontainers.junit.jupiter.Container;
import org.testcontainers.junit.jupiter.Testcontainers;

@Testcontainers
@SpringBootTest
public class YourIntegrationTest {

    @Container
    private static final PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:latest")
            .withDatabaseName("testdb")
            .withUsername("testuser")
            .withPassword("testpass");

    @Test
    void testDatabaseConnection() {
        // 这里写测试逻辑，此时数据库已经就绪
    }
}

这样执行./gradlew build时，Testcontainers会自动启动PostgreSQL容器供测试使用，完全不会出现数据库未就绪的问题，也不用依赖外部容器编排。

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