使用docker.sock时优化Java项目Dockerfile并保留Testcontainers集成测试

核心问题分析 #

当前配置的核心痛点是：ENTRYPOINT 中每次启动容器都会执行 mvn clean package，这会重复触发代码编译、依赖解析和集成测试流程——哪怕代码没有任何变化，也会消耗大量时间和资源。挂载的 docker.sock 仅用于Testcontainers创建测试容器，但和重复打包的高成本无直接关联。

优化方案 #

通过多阶段构建拆分代码构建（含测试）与应用运行环节，让构建过程仅在镜像更新时执行一次，容器启动时直接运行成品JAR包；同时保留Testcontainers集成测试的执行能力。

1. 重构Dockerfile为多阶段构建

将构建和运行拆分为两个独立阶段，构建阶段完成依赖下载、编译、测试与打包，运行阶段仅保留轻量JRE和成品JAR：

# 构建阶段：完成依赖下载、编译、测试与打包
FROM maven:3.8.1-openjdk-8-slim AS builder
WORKDIR /app

# 先复制pom.xml并下载依赖，利用Docker缓存减少重复下载
COPY pom.xml .
RUN mvn dependency:go-offline

# 复制全部代码文件
COPY . .

# 设置Testcontainers测试所需环境变量
ENV POSTGRES_PASSWORD=5e-Jo87_hhNf*9
ENV POSTGRES_USERNAME=postgres
ENV POSTGRES_HOST=postgres
ENV CASSANDRA_HOST=cassandra

# 执行打包，默认会运行所有测试（包括Testcontainers集成测试）
RUN mvn clean package

# 运行阶段：使用轻量JRE镜像，仅保留运行必要文件
FROM openjdk:8-jre-slim
WORKDIR /app

# 从构建阶段复制打好的JAR包
COPY --from=builder /app/target/TechnicalTask_Boot-1.0-SNAPSHOT.jar .

# 设置应用运行所需环境变量
ENV POSTGRES_PASSWORD=5e-Jo87_hhNf*9
ENV POSTGRES_USERNAME=postgres
ENV POSTGRES_HOST=postgres
ENV CASSANDRA_HOST=cassandra

EXPOSE 8080

# 直接启动JAR，无需重复执行Maven命令
ENTRYPOINT ["java", "-jar", "/app/TechnicalTask_Boot-1.0-SNAPSHOT.jar"]

2. 调整Testcontainers测试执行时机

根据场景需求，选择合适的测试执行方式：

场景A：镜像构建阶段自动运行集成测试

如果希望在构建镜像时就确保测试通过，需要让构建容器能访问宿主的Docker守护进程（供Testcontainers创建测试容器）。使用Docker BuildKit执行构建：

DOCKER_BUILDKIT=1 docker build --secret id=docker.socket,src=/var/run/docker.sock -t your-app-image .

注：Testcontainers通常会自动检测Docker套接字路径，若构建时出现连接问题，可在构建阶段添加环境变量 ENV DOCKER_HOST=unix:///var/run/docker.sock

场景B：开发阶段按需运行测试

如果仅需在开发时执行测试，可在镜像构建阶段跳过测试，通过docker-compose挂载本地代码目录，手动触发测试：

修改docker-compose.yaml的app服务：

services:
  app:
    build: ./TechnicalTask_Boot
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./TechnicalTask_Boot:/app  # 挂载本地代码目录，方便实时修改
    depends_on:
      postgres:
        condition: service_healthy
      cassandra:
        condition: service_healthy
    ports:
      - 8080:8080
    # 开发时可手动执行测试，或设置默认命令为测试+启动
    command: sh -c "mvn test && java -jar /app/target/TechnicalTask_Boot-1.0-SNAPSHOT.jar"

此时修改代码后，只需重启容器或在容器内执行mvn test即可重新运行测试，无需重新构建镜像。

3. 额外优化点

• 缓存复用：先复制pom.xml再下载依赖，确保依赖层在pom.xml未修改时不会重新构建。
• 轻量镜像：使用openjdk:8-jre-slim代替maven镜像作为运行时，大幅减少镜像体积。
• 测试隔离：如果Testcontainers会自行创建数据库容器，可考虑在测试时禁用docker-compose中的postgres/cassandra服务，避免端口或资源冲突。

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