Docker Compose中SpringBoot等待Oracle数据库初始化问题求助

核心问题 #

默认的depends_on仅保证Oracle容器启动，不会等待数据库服务完全就绪、初始化脚本执行完成，导致Spring Boot应用启动时因数据库未就绪抛出连接错误。

方案一：通过Health Check + 条件依赖实现（推荐） #

修改你的docker-compose.yml，给Oracle服务添加健康检查，并让Spring Boot应用依赖Oracle的健康状态：

version: '2.1'
services:
  oracle-xe:
    image: gvenzl/oracle-xe:latest
    container_name: oracle
    ports:
      - "1521:1521"
    environment:
      - ORACLE_PASSWORD=oracle
    volumes:
      - ../database/scripts:/docker-entrypoint-initdb.d
    healthcheck:
      test: ["CMD-SHELL", "sqlplus -s system/oracle@//localhost:1521/XE <<< 'SELECT 1 FROM DUAL;' | grep -q '1'"]
      interval: 10s
      timeout: 5s
      retries: 10
      start_period: 60s  # Oracle启动较慢，预留足够初始化时间

  app:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
    depends_on:
      oracle-xe:
        condition: service_healthy  # 仅当Oracle服务健康时才启动应用

配置说明 #

• healthcheck.test：通过sqlplus连接数据库并执行简单查询，验证服务是否就绪（包括初始化脚本执行完成）
• start_period：Oracle首次启动需要较长时间初始化，设置60秒延迟后再开始健康检查
• service_healthy条件：确保Spring Boot应用仅在Oracle数据库完全就绪后才启动

方案二：在Spring Boot应用启动脚本中添加等待逻辑 #

如果不想依赖Docker的健康检查，可以在应用的启动脚本中循环检测Oracle状态，就绪后再启动应用：

1. 在Spring Boot项目根目录创建wait-for-oracle.sh脚本：

#!/bin/bash
# 循环等待Oracle就绪
until sqlplus -s system/oracle@//oracle-xe:1521/XE <<< 'SELECT 1 FROM DUAL;' | grep -q '1'; do
  echo "等待Oracle数据库就绪..."
  sleep 5
done
echo "Oracle数据库已就绪，启动应用..."
exec "$@"

2. 修改应用的Dockerfile，添加脚本并设置为入口：

# 基础镜像（示例用openjdk镜像，需根据实际调整）
FROM openjdk:17-jdk-slim

# 安装sqlplus依赖（不同基础镜像命令不同，例如Oracle Linux用yum）
RUN apt-get update && apt-get install -y --no-install-recommends oracle-client && rm -rf /var/lib/apt/lists/*

# 复制等待脚本
COPY wait-for-oracle.sh /wait-for-oracle.sh
RUN chmod +x /wait-for-oracle.sh

# 复制应用jar包
COPY target/your-app.jar /app.jar

# 设置入口脚本
ENTRYPOINT ["/wait-for-oracle.sh"]
CMD ["java", "-jar", "/app.jar"]

注意事项 #

• 需确保应用镜像中安装了sqlplus工具，不同基础镜像的安装命令需对应调整
• 脚本中的数据库连接信息需与docker-compose.yml中的配置一致

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