Docker内ASP.NET Core应用无法连接同环境SQL Server问题

核心问题：连接字符串中的localhost错误 #

当ASP.NET Core应用在Docker容器内运行时，localhost指向的是容器自身的网络空间，而非宿主机。而你的SQL Server是独立的Docker容器，通过Docker Compose默认网络与API容器互通，此时应该使用**服务名sql**作为数据源地址，而非localhost。

解决方案步骤 #

1. 修改连接字符串 #

将appsettings.json中的连接字符串修改为：

"ConnectionString": "Data Source=sql,1433;Initial Catalog=mycatalog;User ID=SA;Password=mypassword;Connect Timeout=30;Encrypt=False;Trust Server Certificate=False;Application Intent=ReadWrite;Multi Subnet Failover=False"

关键变化：localhost,1433 → sql,1433（sql是你docker-compose配置中定义的SQL服务名）

2. 优化docker-compose配置（可选但推荐） #

添加依赖配置确保API服务在SQL服务启动后再启动，同时增加健康检查，确保SQL Server完全就绪后再启动API：

version: '3.9'
services:
  web_api:
    image: my_app_api
    container_name: my_app_api_container
    ports:
      - "8080:8080"
    depends_on:
      sql:
        condition: service_healthy # 等待SQL服务健康检查通过
  sql:
    image: "mcr.microsoft.com/mssql/server:2022-latest"
    container_name: sql_server2022
    ports:
      - "1433:1433" 
    environment:
      - ACCEPT_EULA=y
      - SA_PASSWORD=mypassword # 生产环境请使用强密码
    healthcheck:
      test: ["CMD-SHELL", "/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P 'mypassword' -Q 'SELECT 1' || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 5

补充说明 #

• Docker Compose默认会为所有服务创建共享网络，服务之间可通过服务名直接通信，无需映射端口（你注释中提到的ports非必需，保留也不影响）。
• 若仍有连接问题，可排查：
  • SQL Server容器是否正常启动（执行docker logs sql_server2022查看日志）
  • SA密码是否与连接字符串完全一致
  • 目标数据库mycatalog是否已存在（若不存在，需确保应用包含自动迁移逻辑，或手动创建）

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