Spring Boot+Docker-Compose启动时DataSource配置失败问题排查

导致DataSource配置失败的原因 #

• JDBC URL格式错误：docker-compose里的DB_URL写成了jdbc:jdbc:postgresql://localhost:5433/rest，多了一个jdbc:，正确格式应为jdbc:postgresql://<host>:<port>/<dbname>
• 容器间网络访问错误：在Spring容器内，localhost指向的是容器自身而非宿主机的Postgres容器。docker-compose中服务间通过服务名通信，应使用db作为数据库主机名，而非localhost
• Postgres端口配置错误：Postgres容器默认内部端口是5432，你将宿主机5433映射到容器5433，但未给Postgres容器设置POSTGRES_PORT环境变量，容器内仍使用默认的5432端口，导致端口不通
• 未自动创建目标数据库：你指定的数据库是rest，但Postgres默认不会自动创建该库，需给db服务添加POSTGRES_DB=rest环境变量
• 数据库未就绪就启动应用：depends_on仅保证启动顺序，不等待Postgres完全初始化完成，Spring启动时数据库可能还未就绪

额外调试方法 #

• 检查容器环境变量是否生效：进入Spring容器执行printenv | grep DB_，确认DB_USER、DB_PASSWORD、DB_URL三个变量是否正确加载
• 测试容器间网络连通性：进入Spring容器执行ping db，或安装psql工具后执行psql -h db -U postgres -d rest，测试数据库连接是否正常
• 开启Spring Boot debug日志：在docker-compose的app服务环境变量中添加SPRING_PROFILES_ACTIVE=debug，重启后查看详细配置加载日志，确认数据源参数是否被正确解析
• 查看Postgres容器日志：执行docker logs db，检查Postgres是否正常启动、有无初始化错误，确认监听端口、目标数据库是否创建成功
• 添加健康检查与等待机制：给db服务配置健康检查，让app服务等待数据库就绪后再启动，示例配置：

db:
  image: 'postgres'
  container_name: db
  ports:
    - '5433:5432' # 修正端口映射，宿主机5433映射容器默认5432
  environment:
    - POSTGRES_USER=postgres
    - POSTGRES_PASSWORD=2042
    - POSTGRES_DB=rest # 自动创建目标数据库
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U postgres -d rest"]
    interval: 5s
    timeout: 5s
    retries: 5
app:
  # ... 其他原有配置
  depends_on:
    db:
      condition: service_healthy # 等待db健康检查通过后启动

• 临时硬编码参数测试：在application.properties中取消注释硬编码的spring.datasource.url，修正主机和端口后测试，排除环境变量传递问题

内容的提问来源于stack exchange，提问作者Ренат Валитов