容器化ASP.NET Core Web API无法连接SQL Server容器的问题咨询

我来帮你梳理这个问题的核心原因，以及对应的解决办法：

核心问题分析 #

你遇到的连接失败主要有两个关键原因：

1. 容器网络寻址错误：你在连接字符串中使用了宿主机的IP（192.168.0.108），但在Docker Compose创建的自定义网络中，容器之间应该通过服务名称（也就是docker-compose.yml里定义的sqlserver）来互相访问。宿主机IP在容器内部访问时会受到Docker网络隔离的限制，而服务名是Docker默认提供的DNS解析方式，能直接指向SQL Server容器的内部IP。
2. 服务就绪时序问题：depends_on配置只是保证Web API容器在SQL Server容器之后启动，但不保证SQL Server服务已经完全启动并可以接受连接。Web API启动时如果SQL Server还在初始化，就会抛出连接失败的异常。

具体解决方案 #

方案1：修改连接字符串使用服务名 #

这是最直接的修复方式，把连接字符串中的服务器地址替换为Docker Compose中SQL Server的服务名：

修改后的连接字符串：

"ConnectionStrings": {
  "SqlConnectionString": "Server=sqlserver,1433;Database=myDb;User Id=sa;Password=StrongPassword;"
}

修改后重新构建并启动容器，Web API就能通过Docker内部网络直接访问SQL Server容器了。

方案2：解决SQL Server启动就绪问题 #

即使修改了连接字符串，也可能因为SQL Server初始化慢导致Web API启动时连接失败，我们可以通过两种方式处理：

方式A：给SQL Server容器添加健康检查

在docker-compose.yml中给sqlserver服务添加健康检查配置，让Web API等待SQL Server完全就绪后再启动：

sqlserver:
  image: mcr.microsoft.com/mssql/server:2019-latest
  ports:
    - 1433:1433
  volumes:
    - my-volume:/var/opt/mssql
  environment:
    SA_PASSWORD: "StrongPassword"
    ACCEPT_EULA: "Y"
  healthcheck:
    test: ["CMD-SHELL", "/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P 'StrongPassword' -Q 'SELECT 1' || exit 1"]
    interval: 10s  # 每10秒检查一次
    timeout: 3s    # 超时时间3秒
    retries: 10    # 最多重试10次

同时修改web_api服务的depends_on，让它等待SQL Server健康检查通过：

web_api:
  build:
    dockerfile: WebApi/Dockerfile
  ports:
    - 5000:80
  depends_on:
    sqlserver:
      condition: service_healthy

方式B：在Web API中添加数据库连接重试逻辑

使用Polly库给数据库连接添加重试策略，即使Web API启动时SQL Server未就绪，也会自动重试直到连接成功：

1. 首先安装Polly相关包：

dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Polly

2. 在Startup.cs（或.NET 5的Program.cs）中配置重试策略：

using Polly;

// ...

services.AddDbContext<YourDbContext>(options =>
{
    options.UseSqlServer(
        Configuration.GetConnectionString("SqlConnectionString"),
        sqlOptions =>
        {
            sqlOptions.EnableRetryOnFailure(
                maxRetryCount: 5,          // 最多重试5次
                maxRetryDelay: TimeSpan.FromSeconds(10), // 每次重试间隔10秒
                errorNumbersToAdd: null    // 自动包含SQL Server的常见连接错误
            );
        });
});

额外验证步骤 #

如果还是有问题，可以做以下验证：

• 检查两个容器是否在同一个Docker网络：运行docker network ls找到Compose创建的网络（通常是<项目名>_default），再用docker inspect <网络名称>查看两个容器是否都在这个网络中。
• 进入Web API容器测试连通性：运行docker exec -it <web_api容器ID> bash，然后用telnet sqlserver 1433测试是否能连接到SQL Server的1433端口（如果容器内没有telnet，可以先安装apt-get update && apt-get install telnet）。

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