Docker Compose部署Spring Boot+MS SQL Server：无法确定合适JDBC URL

我使用Docker Compose部署Spring Boot 2.5.7应用与MS SQL Server 2019，单独测试两者均正常，但组合启动时Spring Boot忽略了docker-compose.yml中配置的SPRING_DATASOURCE_URL，触发如下错误：

Failed to determine suitable jdbc url

相关配置 #

1. Docker Compose配置 #

version: '3.8'
services:
  db:
    ports:
      - 1434:1433
    build: ./db
  api:
    depends_on:
      - db
    build: ./mdm-web-api
    restart: on-failure
    env_file: ./.env
    ports:
      - $SPRING_LOCAL_PORT:$SPRING_DOCKER_PORT
    environment:
      - SPRING_DATASOURCE_URL=jdbc:sqlserver://db:1434;databaseName=dwh-demo;encrypt=true;logingTimeout=30
    stdin_open: true
    tty: true    

2. application.properties配置 #

logging.level.root=INFO
spring.datasource.username=<my-db-user>
spring.datasource.password=<my-ultra-strong-pw>
spring.datasource.driver-class-name=com.microsoft.sqlserver.jdbc.SQLServerDriver
spring.jpa.hibernate.ddl-auto=none
spring.jpa.properties.hibernate.format_sql=true
spring.jpa.properties.hibernate.default_schema:entity_reference
spring.jpa.hibernate.use-new-id-generator-mappings=false
spring.jpa.generate-ddl=false
spring.jpa.show-sql=true
spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
spring.data.rest.basePath=/api
springdoc.api-docs.path=/api-docs

问题原因及解决办法 #

1. 服务间通信端口配置错误 #

Docker Compose内部服务通信使用容器内部端口，而非主机映射端口。你在SPRING_DATASOURCE_URL中指定的db:1434是主机映射到容器的端口，而SQL Server容器内部实际使用的是默认端口1433，这会导致Spring Boot无法找到数据库服务。

修正方案：
修改docker-compose.yml中的SPRING_DATASOURCE_URL，将端口改为1433，同时修正拼写错误的logingTimeout为loginTimeout：

environment:
  - SPRING_DATASOURCE_URL=jdbc:sqlserver://db:1433;databaseName=dwh-demo;encrypt=true;loginTimeout=30

2. 环境变量优先级冲突 #

检查.env文件中是否存在SPRING_DATASOURCE_URL条目——docker-compose中env_file的优先级高于environment字段，若.env中有同名变量，会覆盖你在docker-compose.yml中配置的值。

修正方案：
删除.env文件中的SPRING_DATASOURCE_URL，或修改为正确的数据库连接地址。

3. 数据库启动延迟问题 #

depends_on仅保证容器启动顺序，不保证数据库服务完全就绪。Spring Boot启动时可能数据库还未完成初始化，导致连接失败并触发"无法识别JDBC URL"的错误。

修正方案：

• 在Spring Boot配置中添加连接重试机制，修改application.properties：

  spring.datasource.hikari.connection-timeout=60000
  spring.datasource.hikari.maximum-pool-size=5
  spring.datasource.test-on-borrow=true
  spring.datasource.validation-query=SELECT 1
  

• 或者为api服务添加启动等待脚本（如wait-for-it.sh），确保数据库就绪后再启动应用：
  将脚本复制到Spring Boot镜像中，修改docker-compose.yml的api服务command：

  command: ["./wait-for-it.sh", "db:1433", "--", "java", "-jar", "your-app.jar"]
  

验证步骤 #

1. 修正上述配置后，清理旧容器与数据卷：docker-compose down -v
2. 重新构建并启动服务：docker-compose up --build

内容的提问来源于stack exchange，提问作者Playing With BI