Docker环境下使用DbUp部署SQL Server数据库的问题咨询

一、「配置服务名仍无法连接SQL Server」的核心原因 #

你当前连接串中指定的端口1477是宿主机对外暴露的映射端口，不属于docker-compose内部桥接网络的通信规则：

• compose自建桥接网络内的容器互相访问时，不需要经过宿主机的端口映射流程，直接使用服务名+容器原生监听端口（SQL Server容器内固定监听1433端口）即可通信，你在连接串里写1477相当于在容器内访问不存在的端口，自然无法建立连接。
• 附带易踩坑点：depends_on仅控制容器的启动先后顺序，不会等待SQL Server完成内部初始化、对外提供可连接状态，哪怕端口配置正确，也可能因为SQL Server尚未启动完成触发连接超时。

二、「多启动参数未被正确识别」的核心原因 #

你将包含多个分号的连接串裸写在Dockerfile的Shell命令中，没有做引号包裹，触发两个连锁问题：

1. Shell语法中;是命令分隔符，解析到连接串中的分号时，会将后续的User Id=sa等片段识别为独立的Shell命令执行，因此触发/bin/sh: 1: User: not found这类完全无关的报错。
2. 你将DbUp的运行命令写在了Dockerfile的RUN步骤中，RUN属于镜像构建阶段执行的指令，此时compose网络尚未创建、SQL Server容器完全不存在，就算参数转义正确，也不可能在构建阶段连通数据库。

三、可直接落地的修正配置 #

修正后的DbUp容器Dockerfile #

调整为多阶段构建，去掉镜像构建阶段的运行命令，使用更轻量的ASP.NET运行时镜像作为最终运行环境，避免使用SDK镜像增加不必要的体积：

# 构建阶段
FROM mcr.microsoft.com/dotnet/core/sdk:3.1 AS build
WORKDIR /src
COPY Sentinel.DbUp.csproj Sentinel.DbUp/
RUN dotnet restore Sentinel.DbUp/Sentinel.DbUp.csproj
WORKDIR /src/Sentinel.DbUp
COPY . .
RUN dotnet build Sentinel.DbUp.csproj -c Release -o /app/build

# 最终运行阶段
FROM mcr.microsoft.com/dotnet/core/aspnet:3.1 AS runtime
WORKDIR /app
COPY --from=build /app/build ./
# 固定容器启动入口，避免参数被Shell错误解析
ENTRYPOINT ["dotnet", "Sentinel.DbUp.dll"]

修正后的docker-compose.yml #

• 修正连接端口为容器内部通信的1433
• 将连接串、启动参数通过环境变量传入，完全避开Shell转义问题
• 增加SQL Server健康检查，让DbUp容器等SQL Server真正就绪后再启动

version: "3.7"
services:
  ms-sql-server:
    image: mcr.microsoft.com/mssql/server:2019-latest
    ports:
      - "1477:1433"
    environment:
      SA_PASSWORD: "SuperFun!23"
      ACCEPT_EULA: "Y"
    healthcheck:
      test: ["CMD-SHELL", "/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P SuperFun!23 -Q 'SELECT 1' || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
  dbup-exe:
    build: .
    depends_on:
      ms-sql-server:
        condition: service_healthy
    environment:
      # 容器间通信使用内部1433端口，不需要走宿主机映射的1477
      ConnectionString: "Server=ms-sql-server,1433;Database=Sentinel_Local;User Id=sa;Password=SuperFun!23;"
      WithSeedOnce: "true"
      EnsureDatabase: "true"
      PerformUpgrade: "true"

补充提示：你之前尝试在SQL Server容器内安装.NET Core运行时的方案没有落地价值，官方SQL Server镜像基于最小化精简系统打包，硬装.NET运行时不仅会大幅增加镜像体积，还可能破坏SQL Server的容器运行依赖，拆分为独立DbUp容器的架构是更稳定、可维护的选择。

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