跨系统GitLab CI/CD中Windows环境.NET Core应用测试的SQL Server服务配置问题

我太懂你现在的困境了——在Windows环境的GitLab CI/CD里跑.NET Core测试，要搭个临时SQL Server数据库真的是踩了一堆坑对吧？你试过的两种方案都卡壳了，咱们来一步步拆解解决这个问题。

首先先理清楚你遇到的核心问题：

• 方案1（Linux SQL Server容器 + Windows测试） 失败：因为你的GitLab runner是Windows环境，Docker executor在Windows平台上只能运行Windows容器，拉取Linux版的SQL Server镜像自然会报系统不兼容的错误。
• 方案2（Windows SQL Server容器） 行不通：微软确实已经官方废弃了Windows版的SQL Server容器镜像，自己构建不仅麻烦还容易出各种环境问题。

下面给你几个可行的解决方案，按推荐优先级排序：

方案1：使用Azure SQL Edge容器（官方维护，支持Windows） #

Azure SQL Edge是微软推出的轻量型SQL Server衍生版本，专门针对边缘场景设计，但它有官方维护的Windows容器镜像，功能上和标准SQL Server 2022基本对齐，完全能满足测试需求。

修改你的GitLab CI配置如下：

variables:
  GIT_STRATEGY: clone
  MSSQL_SA_PASSWORD: 'fcdb06d7-44a5-4655-88dd-1e4a7bd5b9de'

default:
  tags:
    - docker
    - windows

services:
  - name: mcr.microsoft.com/azure-sql-edge:latest
    alias: sqlserver
    variables:
      ACCEPT_EULA: Y
      MSSQL_SA_PASSWORD: ${MSSQL_SA_PASSWORD}
      MSSQL_PID: 'Developer'

stages:
  - test

test:
  stage: test
  image: ${CI_REGISTRY}/ist/currated-images/dotnet/sdk:8.0.411
  script:
    # 等待SQL Edge容器启动完成（SQL服务启动需要时间）
    Start-Sleep -Seconds 30
    # 执行数据库初始化脚本
    gci -Path bootstrap -File | %{ Invoke-SqlCommand -Username sa -Password $env:MSSQL_SA_PASSWORD -Hostname sqlserver -InputFile $_.Fullname }
    # 这里添加你的.NET测试命令，比如：
    dotnet test --no-restore --verbosity normal

这个方案的优势是完全基于容器，不用修改runner环境，官方镜像也稳定可靠。

方案2：在Windows Runner上直接安装SQL Server Express #

如果容器方案还是有问题，你可以直接在Windows runner上安装SQL Server Express版本（免费，满足测试需求），不用依赖容器。

修改test阶段的script部分：

test:
  stage: test
  tags:
    - docker
    - windows
  image: ${CI_REGISTRY}/ist/currated-images/dotnet/sdk:8.0.411
  script:
    # 下载SQL Server Express安装包
    Invoke-WebRequest -Uri "https://go.microsoft.com/fwlink/?linkid=2257644" -OutFile "SqlServerSetup.exe"

    # 静默安装SQL Server Express
    .\SqlServerSetup.exe /Q /IACCEPTSQLSERVERLICENSETERMS /ACTION=Install `
      /FEATURES=SQLEngine /INSTANCENAME=MSSQLSERVER `
      /SQLSVCACCOUNT="NT AUTHORITY\NETWORK SERVICE" `
      /SQLSYSADMINACCOUNTS="BUILTIN\Administrators" `
      /SAPWD=$env:MSSQL_SA_PASSWORD

    # 等待SQL服务启动完成
    do {
        $sqlService = Get-Service -Name MSSQLSERVER -ErrorAction SilentlyContinue
        Start-Sleep -Seconds 5
    } while ($null -eq $sqlService -or $sqlService.Status -ne 'Running')

    # 执行初始化脚本
    gci -Path bootstrap -File | %{ Invoke-SqlCommand -Username sa -Password $env:MSSQL_SA_PASSWORD -Hostname localhost -InputFile $_.Fullname }

    # 执行测试
    dotnet test --no-restore

    # 可选：测试完成后卸载SQL Server（如果是共享runner，避免影响其他任务）
    # .\SqlServerSetup.exe /Q /ACTION=Uninstall /FEATURES=SQLEngine

这个方案的优点是兼容性拉满，不用考虑容器跨系统问题；缺点是安装耗时较长，如果你用的是共享runner，建议加上卸载步骤，避免污染环境。

方案3：拆分任务到混合Runner（适合复杂场景） #

如果你的团队同时有Linux和Windows runner，可以把数据库初始化和测试拆分：

1. 用Linux runner启动Linux版SQL Server容器，完成bootstrap初始化，导出数据库备份文件
2. 将备份文件传到Windows runner
3. Windows runner本地恢复备份，再执行测试

不过这个方案需要跨runner传递文件，配置相对复杂，一般前两个方案足够解决问题。

内容来源于stack exchange