如何为基于Maven的Spring Boot正确配置Dockerfile并解决启动问题

问题背景 #

现有配置 #

1. Dockerfile：

FROM adoptopenjdk:8-jdk-hotspot
ARG JAR_FILE=*.jar
COPY ${JAR_FILE} application.jar
ENTRYPOINT ["java", "-jar", "application.jar"]

2. docker-compose.yml：

version: '2'

services:
  app:
    image: 'my-app:latest'
    build:
      context: .
    container_name: app
    depends_on:
      - my-postgres
    environment:
      - SPRING_DATASOURCE_URL=jdbc:postgresql://db:5432/mydb
      - SPRING_DATASOURCE_USERNAME=user1
      - SPRING_DATASOURCE_PASSWORD=user.1
      - SPRING_JPA_HIBERNATE_DDL_AUTO=update

  my-postgres:
    image: 'postgres:13.1-alpine'
    container_name: db
    environment:
      - POSTGRES_USER=user1
      - POSTGRES_PASSWORD=user.1
      - POSTGRES_DB=mydb
    volumes:
      - ./postgres-data:/var/lib/postgresql/data
      # 注：原路径存在拼写错误，正确路径应为/docker-entrypoint-initdb.d/
      - ./sql/baseline.sql:/docker-entrypoint-initdb.d/baseline.sql

遇到的问题 #

1. 构建镜像后通过docker-compose启动，应用容器无法正常运行，仅能在docker ps -a中查到。直接执行java -jar application.jar启动失败，提示缺少配置文件，但本地用mvn spring-boot:run可正常启动，需解决Dockerfile的正确配置（不考虑ENTRYPOINT ["mvn", "spring-boot:run"]写法）。
2. 升级Spring Boot版本后，用mvn spring-boot:build-image构建镜像，docker-compose可运行但应用容器快速退出，启动命令为/cnb/process/web，需定位并解决该问题。

问题1：Java -jar启动缺配置的解决方法 #

核心原因 #

mvn spring-boot:run会自动加载项目src/main/resources下的配置文件，但如果打包后的jar未包含配置文件，或运行时需要外部配置，就会出现启动失败。另外需注意postgres初始化脚本的路径错误，可能导致数据库表未创建，间接引发应用启动失败。

具体解决方案 #

方案1：确保配置文件被打包进jar

执行mvn clean package后，解压jar包（unzip application.jar），检查BOOT-INF/classes目录下是否存在你的配置文件（如application.properties/yml）。若缺失，检查pom.xml的资源配置，确保默认路径被正确打包：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*</include>
            </includes>
        </resource>
    </resources>
</build>

方案2：挂载外部配置文件到容器

若需外部管理配置文件，可在docker-compose中挂载配置目录，并修改启动命令指定配置路径：
修改docker-compose的app服务：

app:
  # 保留原有配置
  volumes:
    - ./src/main/resources:/app/resources

修改Dockerfile的ENTRYPOINT：

ENTRYPOINT ["java", "-jar", "application.jar", "--spring.config.location=/app/resources/"]

方案3：用环境变量补全配置

你已在docker-compose中配置了数据库相关环境变量，若还有其他配置缺失，可通过SPRING_XXX_XXX格式的环境变量注入（如SPRING_PROFILES_ACTIVE=prod），Spring Boot会自动识别并覆盖配置。

问题2：spring-boot:build-image构建容器快速退出的解决方法 #

核心原因 #

mvn spring-boot:build-image基于Cloud Native Buildpacks构建镜像，/cnb/process/web是其标准启动命令。容器快速退出通常是应用启动失败（如数据库未就绪、配置缺失）导致的，需通过日志定位具体问题。

具体解决方案 #

1. 查看容器日志定位错误
   执行docker logs app（替换为你的容器名），直接查看应用启动失败的具体原因，比如数据库连接超时、配置项缺失等。

2. 确保postgres服务就绪后启动应用
   depends_on仅保证postgres容器先启动，不保证数据库服务就绪。需升级docker-compose版本到3+，并添加健康检查：
   修改docker-compose.yml：

version: '3.8'

services:
  app:
    # 保留原有配置
    depends_on:
      my-postgres:
        condition: service_healthy

  my-postgres:
    # 保留原有配置
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user1 -d mydb"]
      interval: 5s
      timeout: 5s
      retries: 5

3. 验证环境变量传递
   确保所有必要的环境变量（如数据库URL、用户名）都正确传递到容器中，Cloud Native Buildpacks构建的镜像完全支持Spring Boot的环境变量配置规则。

4. 进入容器排查细节
   若日志无明确线索，可进入容器内部查看详细信息：

docker exec -it app bash
# 查看应用日志或配置文件，通常日志路径为/var/log或应用工作目录

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