Spring Boot无法连接Docker部署的PostgreSQL，求排查错误原因

1. Docker网络访问配置错误 #

• 若Spring Boot在宿主机运行，PostgreSQL在Docker容器内，禁止使用localhost作为数据库主机地址：
  • 执行docker inspect <postgres容器ID> | grep IPAddress获取容器实际IP，将application.yml中的spring.datasource.url主机部分替换为该IP
  • 若Spring Boot与PostgreSQL同属一个docker-compose编排，直接用PostgreSQL服务名作为主机名（比如docker-compose中服务名为db，则URL写为jdbc:postgresql://db:5432/你的数据库名）

2. 容器端口映射异常 #

• 检查docker-compose.yaml的ports配置，确认是否为5432:5432；若映射为其他端口（如5433:5432），需同步修改application.yml中的端口号
• 执行docker ps确认PostgreSQL容器状态为Up，且端口映射规则生效

3. PostgreSQL容器内部监听配置问题 #

• 进入容器执行docker exec -it <postgres容器ID> bash，检查postgresql.conf中listen_addresses是否设为'*'（允许所有地址访问）
• 检查pg_hba.conf是否添加允许外部连接的规则：host all all 0.0.0.0/0 md5（测试场景使用，生产环境需限制IP范围）

4. Spring Boot配置细节错误 #

• 核对application.yml中spring.datasource.url格式：必须为jdbc:postgresql://<主机>:<端口>/<数据库名>，避免主机、端口、数据库名拼写错误
• 确认spring.datasource.username和spring.datasource.password与docker-compose.yaml中POSTGRES_USER、POSTGRES_PASSWORD环境变量完全一致
• 检查配置项名称是否正确，比如是否误写为spring.datasource.uri而非spring.datasource.url

5. Flyway启动时机问题 #

• 若Spring Boot与PostgreSQL同属docker-compose编排，需为Spring Boot服务添加依赖配置，确保数据库完全就绪后再启动：

  depends_on:
    - postgres服务名
  

• 或使用wait-for-it等脚本，让Spring Boot等待PostgreSQL端口可用后再初始化Flyway，避免数据库未就绪时触发连接失败

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