依赖启动顺序怎么解决初始化SQL未执行完崩溃-Docker-PHP中文网

Docker Ctl

使用 podman 检查容器、日志和镜像

核心在于区分容器启动、数据库就绪和sql初始化完成三层状态；推荐由spring boot控制初始化，配合healthcheck与wait-for-it确保顺序，并在生产环境禁用自动初始化，改用flyway/liquibase。

核心问题不在“启动顺序”，而在于“服务就绪”和“数据就绪”是两个不同阶段——数据库容器启动了，不代表 mysql 已完成初始化，更不代表 spring boot 的 schema.sql / data.sql 已执行完毕。应用一上来就连库建表、查用户，而此时表还没建好，自然崩溃。

关键区分：容器启动 ≠ 数据库就绪 ≠ SQL 初始化完成

这是最容易混淆的三层状态：

容器启动：Docker 把 MySQL 进程拉起来了（mysqld 进程在跑），但可能还在加载系统表、恢复日志、校验 datadir
数据库就绪：MySQL 能响应 mysql -h db -u root -e "SELECT 1"，即 TCP 可连、认证通过、基础服务可用
SQL 初始化完成：Spring Boot 的 spring.sql.init.mode=always 已成功执行完 schema.sql 和 data.sql，所有业务表已存在、基础数据已插入

前两层靠 healthcheck + service_healthy 可控；第三层必须由应用自身控制或显式等待，不能交给 Docker Compose。

推荐方案：让 Spring Boot 控制初始化时机，而非依赖外部顺序

最稳妥的做法，是把初始化逻辑收归应用层，避免跨容器协调。只需确保两点：

数据库容器先于应用容器启动（用 depends_on 即可）
应用启动时，主动等待数据库就绪，并按需执行 SQL 初始化

配置示例（Spring Boot 3.x + Docker Compose）：

services:
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: rootpass
      MYSQL_DATABASE: myapp
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-prootpass"]
      interval: 10s
      timeout: 5s
      retries: 10
      start_period: 60s
<p>app:
build: .
depends_on:
db:
condition: service_healthy
environment:
SPRING_SQL_INIT_MODE: always
SPRING_SQL_INIT_SCHEMA: always
SPRING_SQL_INIT_DATA: always</p><h1>确保初始化失败时抛异常，不静默跳过</h1><pre class="brush:php;toolbar:false;">  SPRING_SQL_INIT_CONTINUE_ON_ERROR: "false"

注意：SPRING_SQL_INIT_* 配置仅在应用首次启动且表不存在时生效；若已有表，Spring 默认跳过。如需强制重跑，请改用 always 并配合 spring.sql.init.drop-first=true（仅限开发/测试）。

进阶防护：加一层启动前健康等待脚本

即使有了 service_healthy，Spring Boot 启动仍可能早于 SQL 执行完成（尤其 SQL 文件较大时）。可在应用镜像中嵌入轻量等待逻辑：

在 Dockerfile 中加入 wait-for-it.sh 或使用 dockerize
修改启动命令为：["sh", "-c", "wait-for-it db:3306 --timeout=120 -- spring-boot:run"]

或直接在 Spring Boot 启动类中增加简单检查（适合调试）：

@EventListener
public void handleContextRefresh(ContextRefreshedEvent event) {
    JdbcTemplate template = event.getApplicationContext().getBean(JdbcTemplate.class);
    try {
        template.queryForObject("SELECT COUNT(*) FROM user", Integer.class);
    } catch (Exception e) {
        throw new IllegalStateException("Required table 'user' not initialized yet", e);
    }
}