Spring Cloud微服务Docker部署遇连接拒绝及数据库问题求助

一、Eureka Server 连接超时异常排查 #

• 检查docker-compose中Eureka服务的端口映射配置，确保ports: - "8761:8761"正确配置，宿主机或容器能访问该端口。
• 查看Eureka容器日志，确认服务是否完成启动，且绑定到0.0.0.0（避免仅绑定localhost导致容器外部无法访问）。
• 核对Eureka配置文件：
  • 若使用容器名访问，确保eureka.instance.hostname设置为Eureka容器的服务名；
  • 或开启IP地址优先：eureka.instance.prefer-ip-address=true，让服务自动获取容器IP注册。
• 确认所有服务都加入同一个docker-compose自定义网络，比如在文件中定义networks: - spring-cloud-network，并给每个服务指定该网络，避免跨网络访问限制。

二、API Gateway/业务服务连接Eureka被拒绝排查 #

• 检查各服务的Eureka注册配置，eureka.client.serviceUrl.defaultZone必须指向Eureka容器的服务名+端口（例如http://eureka-server:8761/eureka/），禁止使用localhost或宿主机IP（容器内localhost指向自身，而非宿主机）。
• 配置服务启动顺序：在docker-compose中给依赖Eureka的服务添加depends_on: - eureka-server，同时建议给业务服务添加启动延迟（比如command: ["sh", "-c", "sleep 15 && java -jar app.jar"]），避免Eureka未就绪时发起连接。
• 排查容器网络连通性：进入某业务服务容器，执行curl http://eureka-server:8761，验证是否能正常访问Eureka页面，定位是网络问题还是配置问题。

三、java.sql.Driver 实例化失败排查 #

• 核对依赖配置：确认pom.xml/build.gradle中引入了对应数据库的驱动依赖，比如MySQL 8.0+需引入mysql-connector-j（替代旧版mysql-connector-java），且版本与MySQL服务器兼容。
• 检查驱动类名：MySQL 8.0+的驱动类是com.mysql.cj.jdbc.Driver，旧版是com.mysql.jdbc.Driver，确保spring.datasource.driver-class-name配置正确，写错会直接导致实例化失败。
• 验证数据库连接URL：MySQL 8.0+需指定时区等参数，例如jdbc:mysql://mysql-server:3306/your_db?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true，缺少必要参数可能引发驱动加载异常。
• 确认数据库容器可达：进入业务服务容器，执行ping mysql-server验证容器名解析正常，确保数据库服务与业务服务在同一个docker-compose网络内。

内容的提问来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu