ASP.NET Core 7应用DockerHub镜像部署后无法连接SQL Server

核心问题 #

报错显示应用尝试连接(localdb)\mssqllocaldb，而非docker-compose中定义的sql_server容器，说明部署到DockerHub的镜像中，连接字符串未正确配置为容器化数据库地址。本地构建正常是因为构建过程中使用了正确的开发环境配置，而DockerHub镜像可能打包了错误的默认配置。

解决方案 #

1. 用环境变量强制覆盖连接字符串 #

在docker-compose.yml的web_app服务中添加环境变量，直接指定正确的连接字符串，绕过镜像内的配置文件：

version: "3.9"
services:
  database:
    image: "mcr.microsoft.com/mssql/server:latest"
    container_name: sql_server 
    environment:
      - ACCEPT_EULA=y
      - MSSQL_SA_PASSWORD=ticketAppPassword77%
    restart: always
    ports:
      - "1433:1433"
  web_app:
    image: "borjanob/ticket_app:latest"
    container_name: web_app_application
    ports:
      - "8080:80"
    depends_on:
      - database
    environment:
      - ConnectionStrings__DefaultConnection=Server=sql_server,1433;Database=TicketApplicationDb;User Id=sa;Password=ticketAppPassword77%;MultipleActiveResultSets=true;Encrypt=True;TrustServerCertificate=true

注：Docker环境变量中用双下划线__替代配置文件里的冒号:，来映射层级结构（比如ConnectionStrings:DefaultConnection对应ConnectionStrings__DefaultConnection）

2. 检查并修正镜像内的配置文件 #

如果希望镜像本身包含正确的连接字符串，需：

• 确认项目根目录的appsettings.json中，连接字符串已替换为容器化版本，而非localdb：

  {
    "ConnectionStrings": {
      "DefaultConnection": "Server=sql_server,1433;Database=TicketApplicationDb;User Id=sa;Password=ticketAppPassword77%;MultipleActiveResultSets=true;Encrypt=True;TrustServerCertificate=true"
    }
  }
  

• 重新构建并推送镜像到DockerHub：

  docker build -t borjanob/ticket_app:latest .
  docker push borjanob/ticket_app:latest
  

3. 验证镜像内的配置是否正确 #

可以临时启动镜像，查看内部的appsettings.json内容，确认连接字符串：

docker run -it --rm borjanob/ticket_app:latest cat appsettings.json

4. 确保数据库容器完全启动后再启动应用 #

depends_on仅保证容器启动顺序，不保证数据库服务就绪。可添加健康检查或延迟启动：
在database服务中添加健康检查：

database:
  image: "mcr.microsoft.com/mssql/server:latest"
  container_name: sql_server 
  environment:
    - ACCEPT_EULA=y
    - MSSQL_SA_PASSWORD=ticketAppPassword77%
  restart: always
  ports:
    - "1433:1433"
  healthcheck:
    test: ["CMD-SHELL", "/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P ticketAppPassword77% -Q 'SELECT 1' || exit 1"]
    interval: 10s
    timeout: 5s
    retries: 5

然后在web_app服务中添加depends_on的健康检查依赖：

web_app:
  # ...其他配置
  depends_on:
    database:
      condition: service_healthy

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