无法通过SSMS连接Docker中SQL Server实例的问题求助

问题描述 #

我尝试通过Microsoft SQL Management Studio（SSMS）连接Docker部署的SQL Server实例，我的docker-compose配置如下：

services:
  reactapp1.server:
    image: ${DOCKER_REGISTRY-}reactapp1server
    build:
      context: .
      dockerfile: src/ReactApp1.Server/Dockerfile
    ports:
      - 5400:80
      - 5401:443
    depends_on:
      - sqlserver
  sqlserver:
    restart: unless-stopped
    image: "mcr.microsoft.com/mssql/server:latest"
    environment:
        SA_PASSWORD: "YourStrong@Passw0rd123"
        MSSQL_SA_PASSWORD: "YourStrong@Passw0rd123"
        ACCEPT_EULA: "Y"
    volumes:
      - "./data:/var/opt/mssql/data"
    ports:
      - 5050:1433

连接SQL Server的数据库连接字符串配置如图所示。尝试连接时，Visual Studio的Docker日志偶尔会出现以下报错：

未配置有效的TLS证书以接受严格（TDS 8.0及以上）连接。连接已关闭。

Microsoft SQL Server Management Studio的报错信息为：

在建立与SQL Server的连接时出现与网络相关的或特定于实例的错误。未找到服务器或无法访问服务器。验证实例名称是否正确，以及SQL Server是否配置为允许远程连接。(provider: 命名管道提供程序, error: 40 - 无法打开到SQL Server的连接) (Framework Microsoft SqlClient Data Provider)

我正在按照教程操作，已经删除所有Docker资源并重新启动，但问题仍未解决，请问无法连接的原因是什么？

问题分析与解决办法 #

1. TLS证书与TDS版本冲突 #

Docker中的SQL Server默认未配置有效TLS证书，而新版SSMS或数据库驱动默认启用TDS 8.0严格加密模式，导致连接被拒绝。

• 临时解决（测试环境）：在连接字符串中添加TrustServerCertificate=True或Encrypt=Optional；或者在docker-compose的sqlserver服务环境变量中追加MSSQL_ENCRYPTION=0，禁用强制加密。
• 生产环境：为SQL Server容器配置合法的TLS证书。

2. 网络端口或连接地址错误 #

SSMS报错指向命名管道连接失败，核心原因大概率是连接参数错误：

• 连接SSMS时，服务器名称需填写主机IP,5050（比如localhost,5050或你的本机IP加端口），因为docker-compose将容器的1433端口映射到了主机的5050端口，不要使用默认的1433端口。
• 检查主机防火墙是否允许5050端口的入站连接，可临时关闭防火墙测试。
• 确认SQL Server容器状态：执行docker ps查看容器是否处于Up状态；若容器反复重启，执行docker logs <容器ID>查看启动日志，排查是否有初始化错误。

3. SA密码配置冗余 #

docker-compose中同时设置了SA_PASSWORD和MSSQL_SA_PASSWORD，新版SQL Server优先读取MSSQL_SA_PASSWORD，但冗余配置可能引发潜在问题，建议只保留MSSQL_SA_PASSWORD这一项环境变量。

4. 容器就绪状态判断问题 #

depends_on仅保证容器启动顺序，不确保SQL Server服务完全就绪。SQL Server容器启动通常需要1-2分钟初始化，若提前尝试连接会失败。

• 解决办法：手动等待容器启动完成（可通过docker logs查看是否出现SQL Server is now ready for client connections日志）后再尝试连接；或在应用中添加连接重试逻辑。

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