如何解决SQLServer容器与Spring Boot容器连接失败问题

核心原因 #

Spring Boot容器内配置的数据库连接地址为localhost:1433，但容器的localhost指向自身而非SQL Server容器。虽然你已创建自定义Docker网络，但未正确利用容器名称的DNS解析能力。

解决步骤 #

1. 修改数据库连接配置
   打开Spring Boot的配置文件（如application.properties或application.yml），将SQL Server连接URL中的localhost替换为SQL Server容器的名称sqlserver：

   • Properties格式示例：

     spring.datasource.url=jdbc:sqlserver://sqlserver:1433;databaseName=你的数据库名
     spring.datasource.username=sa
     spring.datasource.password=Password!
     

   • YML格式示例：

     spring:
       datasource:
         url: jdbc:sqlserver://sqlserver:1433;databaseName=你的数据库名
         username: sa
         password: Password!
     

2. 重新构建并运行容器
   先清理旧容器（若存在）：

   docker stop wcas && docker rm wcas
   

   重新打包应用并构建镜像：

   mvn clean install -DskipTests
   docker build -t wcas .
   

   启动新容器：

   docker run -d -p 8080:8080 --network wcas-network --name wcas wcas
   

验证方法 #

若仍有疑问，可进入Spring Boot容器测试网络连通性：

docker exec -it wcas /bin/bash
# 测试容器名称解析
ping sqlserver
# 测试端口可达性（容器内无telnet可先安装：apt update && apt install -y telnet）
telnet sqlserver 1433

补充说明 #

你之前的MySQL双容器示例能正常运行，大概率是因为MySQL场景中使用了容器名称作为连接地址，而非localhost。Docker自定义网络默认支持容器名称的DNS解析，只要两个容器在同一网络下，即可通过容器名称直接通信，无需依赖宿主机端口映射。

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