Vagrant配置脚本中使用SqlCmd连接SQL Server失败求助

核心问题分析 #

Vagrant的provision脚本以**系统本地账户（Local System）**运行，而手动登录虚拟机使用的是交互式用户账户，二者在SQL Server权限、服务就绪状态、网络协议访问上存在差异：

1. SQL Server服务可能在虚拟机重启后尚未完全就绪，脚本就开始执行连接
2. 默认安装的SQL Server Express可能未启用TCP/IP协议，系统账户无法通过网络方式连接
3. 系统账户下使用计算机名（LOCALDEV）连接时，可能存在DNS/NetBIOS解析问题

具体修复步骤 #

1. 修改dependencies.ps1：启用必要的SQL Server协议与服务 #

在Choco安装SQL Server的命令后，添加配置TCP/IP协议、重启服务的代码，确保实例可被系统账户访问：

choco install sql-server-express -o -ia "'/IACCEPTSQLSERVERLICENSETERMS /Q /ACTION=install /INSTANCEID=MSSQLSERVER /INSTANCENAME=MSSQLSERVER /UPDATEENABLED=FALSE'" -y

# 启用SQL Server TCP/IP协议（针对默认实例MSSQLSERVER）
$sqlInstance = "MSSQLSERVER"
$tcpProtocol = Get-WmiObject -Namespace root\Microsoft\SqlServer\ComputerManagement15 -Class ServerNetworkProtocol -Filter "InstanceName='$sqlInstance' and ProtocolName='Tcp'"
$tcpProtocol.IsEnabled = $true
$tcpProtocol.Put() | Out-Null

# 重启SQL Server服务使配置生效
Restart-Service -Name "MSSQL`$$sqlInstance" -Force -ErrorAction SilentlyContinue

# 设置SQL Browser服务为自动启动（确保实例可被识别）
Set-Service -Name "SQLBrowser" -StartupType Automatic
Start-Service -Name "SQLBrowser" -ErrorAction SilentlyContinue

2. 修改sql.ps1：等待服务就绪并使用可靠连接字符串 #

添加服务等待逻辑，确保SQL Server完全启动后再执行连接；同时使用共享内存协议或本地实例简写，避免网络解析问题：

# 等待SQL Server默认实例服务完全启动
$sqlServiceName = "MSSQL`$MSSQLSERVER"
do {
    $service = Get-Service -Name $sqlServiceName -ErrorAction SilentlyContinue
    if ($service -and $service.Status -eq 'Running') {
        Write-Host "SQL Server service is running, attempting connection..."
        break
    }
    Start-Sleep -Seconds 3
} while ($true)

# 方案1：使用共享内存协议连接（最可靠，无需网络配置）
SqlCmd -E -S "np:\\.\pipe\sql\query" -Q "SELECT name FROM master.sys.databases"

# 方案2：使用本地默认实例简写（若TCP/IP已启用）
# SqlCmd -E -S "." -Q "SELECT name FROM master.sys.databases"

3. 保持Vagrantfile配置不变 #

维持原有的provision执行顺序，确保安装、重启、配置流程完整：

config.vm.provision :shell, path: "./dependencies.ps1"
config.vm.provision :shell, reboot: true
config.vm.provision :shell, path: "./sql.ps1"

额外权限修复（若仍连接失败） #

如果系统账户无SQL Server管理员权限，可在dependencies.ps1末尾添加命令，将Local System账户添加为sysadmin角色：

SqlCmd -E -S "." -Q "CREATE LOGIN [NT AUTHORITY\SYSTEM] FROM WINDOWS; ALTER SERVER ROLE sysadmin ADD MEMBER [NT AUTHORITY\SYSTEM];"

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