Windows 11 Pro下SQL Server容器启动无响应问题求助

核心问题1：LocalDB无法适配Docker容器环境 #

你当前的连接字符串指向(localdb)\MSSQLLocalDB，这是Windows专属的本地SQL Server轻量版本，Docker容器（无论Windows还是Linux环境）都无法直接访问宿主机的LocalDB实例，必须改用Docker部署的独立SQL Server服务。

核心问题2：SQL Server容器启动挂起的潜在诱因 #

容器启动后无响应，大概率是以下原因导致：

1. 内存资源不足：SQL Server官方镜像至少需要2GB可用内存，资源配额不足会直接导致进程挂起。
2. SA密码不满足复杂度要求：SQL Server强制要求SA密码包含大写、小写、数字、特殊字符，长度≥8位，你配置的xxxxxxxxx可能不符合规则。
3. 未指定稳定版本：mcr.microsoft.com/mssql/server默认拉取最新版，部分环境存在兼容性问题，建议指定具体稳定版本（如2019-latest）。

分步解决方案 #

1. 修正Docker Compose配置

更新docker-compose.yml，解决SQL Server启动问题并配置服务间正确通信：

version: "3"
services:
    sportsstore:
        build: .
        ports:
           - "5000:5000"
        environment:
           - ASPNETCORE_ENVIRONMENT=Production
           # 用Docker服务名作为SQL服务器地址
           - ConnectionStrings__SportsStoreConnection=Server=sqlserver;Database=SportsStore;User Id=sa;Password=YourStrong!Passw0rd;MultipleActiveResultSets=true
           - ConnectionStrings__IdentityConnection=Server=sqlserver;Database=Identity;User Id=sa;Password=YourStrong!Passw0rd;MultipleActiveResultSets=true
        depends_on:
           - sqlserver
    sqlserver:
        image: "mcr.microsoft.com/mssql/server:2019-latest" # 指定稳定版本
        ports:
           - "1433:1433" # 暴露端口方便本地调试
        environment:
          SA_PASSWORD: "YourStrong!Passw0rd" # 符合复杂度要求的密码
          ACCEPT_EULA: "Y"
          MSSQL_PID: "Express" # 可选：使用免费Express版本降低资源占用
        volumes:
           - sqlserver-data:/var/opt/mssql # 挂载数据卷持久化数据
volumes:
    sqlserver-data:

2. 修正应用连接字符串

移除appsettings.json中指向LocalDB的配置，或直接用Docker环境变量覆盖（上述Compose配置已完成此操作），确保连接字符串使用容器内SQL服务地址：

"ConnectionStrings": {
    "SportsStoreConnection": "Server=sqlserver;Database=SportsStore;User Id=sa;Password=YourStrong!Passw0rd;MultipleActiveResultSets=true",
    "IdentityConnection": "Server=sqlserver;Database=Identity;User Id=sa;Password=YourStrong!Passw0rd;MultipleActiveResultSets=true"
}

注：Docker Compose会自动创建内部网络，服务名sqlserver可直接作为主机名访问。

3. 配置足够宿主机资源

• Docker Desktop用户：进入「设置→资源→高级」，分配至少2GB内存。
• Linux宿主机：确保可用内存≥2GB，swap空间配置充足。

4. 查看容器日志定位问题

若容器仍挂起，执行以下命令查看SQL Server日志，明确失败原因：

docker-compose logs sqlserver

5. 正确启动服务与连接重试

不要单独启动SQL容器，直接启动所有服务，并在ASP.NET Core中添加数据库连接重试逻辑，避免因SQL服务未就绪导致应用启动失败：

docker-compose up -d

在Program.cs中配置重试：

builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(
        builder.Configuration.GetConnectionString("SportsStoreConnection"),
        b => b.EnableRetryOnFailure(maxRetryCount: 5, maxRetryDelay: TimeSpan.FromSeconds(10), errorNumbersToAdd: null)));

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