Spring WebFlux/PostgreSQL启动时Docker-Compose无法创建表

核心问题拆解 #

你的配置同时用到了JPA（Hibernate）和R2DBC，但自动建表逻辑没触发，大概率是这几个原因：

• depends_on仅保证容器启动顺序，不等待PostgreSQL服务完全就绪，应用启动时连不上数据库，导致初始化步骤直接跳过
• R2DBC和JPA的初始化配置冲突，导致schema.sql或Hibernate的DDL语句没执行
• 持久化卷postgres-data中残留了旧数据库数据，CREATE TABLE IF NOT EXISTS因表已存在不生效

具体解决步骤 #

1. 让应用等数据库就绪后再启动 #

修改docker-compose.yml，给PostgreSQL服务添加健康检查，确保数据库可用后再启动应用：

version: '3.8'

services:
  db:
    image: postgres:17
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: mydb
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    # 新增健康检查
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres -d mydb"]
      interval: 5s
      timeout: 5s
      retries: 5

  app:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://db:5432/mydb
      SPRING_DATASOURCE_USERNAME: postgres
      SPRING_DATASOURCE_PASSWORD: postgres
      SPRING_R2DBC_URL: r2dbc:postgresql://db:5432/mydb
      SPRING_R2DBC_USERNAME: postgres
      SPRING_R2DBC_PASSWORD: postgres
      SPRING_JPA_HIBERNATE_DDL_AUTO: create
    # 修改依赖条件，等数据库健康检查通过再启动
    depends_on:
      db:
        condition: service_healthy

volumes:
  postgres-data:

2. 统一初始化逻辑（二选一即可） #

方案A：用R2DBC的schema.sql初始化

保留schema.sql，关闭JPA的DDL自动生成避免冲突，修改application.properties：

spring.application.name=my-project-service

spring.datasource.url=jdbc:postgresql://db:5432/mydb
spring.datasource.username=postgres
spring.datasource.password=postgres

spring.r2dbc.url=r2dbc:postgresql://db:5432/mydb
spring.r2dbc.username=postgres
spring.r2dbc.password=postgres

# 关闭JPA自动建表
spring.jpa.hibernate.ddl-auto=none
# 强制执行R2DBC初始化脚本
spring.r2dbc.initialization-mode=always

方案B：用JPA（Hibernate）自动建表

如果想用实体类自动生成表，确保实体类被Spring扫描到（比如主启动类加@EntityScan），然后关闭R2DBC初始化：

spring.application.name=my-project-service

spring.datasource.url=jdbc:postgresql://db:5432/mydb
spring.datasource.username=postgres
spring.datasource.password=postgres

spring.r2dbc.url=r2dbc:postgresql://db:5432/mydb
spring.r2dbc.username=postgres
spring.r2dbc.password=postgres

# 开启JPA自动建表
spring.jpa.hibernate.ddl-auto=create
# 关闭R2DBC初始化脚本
spring.r2dbc.initialization-mode=never
# 可选：显示SQL语句，验证建表逻辑是否执行
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

3. 清除旧的持久化数据（关键） #

如果之前启动过容器，postgres-data卷里可能已有旧数据库，导致CREATE TABLE IF NOT EXISTS不生效，先删除卷再重新启动：

docker-compose down -v
docker-compose up --build

4. 排查启动日志 #

启动后查看应用容器的日志，确认初始化逻辑是否执行：

docker-compose logs app

如果看到Failed to obtain R2DBC Connection说明数据库还没就绪；如果看到Executing SQL script from class path resource [schema.sql]说明脚本已执行。

验证方法 #

启动后进入PostgreSQL容器，手动检查表是否存在：

docker-compose exec db psql -U postgres -d mydb
# 列出所有表
\dt

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