Scaffold-DbContext执行失败：SQL Server无法连接问题求助

使用SQL Server Management Studio v18创建数据库，身份验证方式设置为SQL Server身份验证。尝试在包管理器控制台执行以下Scaffold-DbContext命令：

Scaffold-DbContext "Password=dummy;Persist Security Info=True;User ID=dummy;Initial Catalog=SomeDB;Encrypt=false;Data Source=DESKTOP-MYDESKTOP" 
        -tables MyTable Microsoft.EntityFrameworkCore.SqlServer 
        -OutputDir CompanyEntities

尽管凭据正确，仍收到错误：

Network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible. Verify that the instance name is correct and that SQL Server is configured to allow remote connections. (provider: Named Pipes Provider, error: 40 - Could not open a connection to SQL Server)

已检查服务器的sp_configure 'remote access'值，设置为0（符合需求）。

环境信息：

• Microsoft.EntityFrameworkCore 7.0.0
• Microsoft.EntityFrameworkCore.SqlServer 7.0.0
• .NET 7

1. 确认SQL Server实例名称正确性 #

• 打开SQL Server配置管理器，查看SQL Server服务名称：默认实例服务名为SQL Server (MSSQLSERVER)，此时连接字符串Data Source可填DESKTOP-MYDESKTOP或localhost；若为命名实例（如SQL Server (SQLEXPRESS)），则需写成DESKTOP-MYDESKTOP\SQLEXPRESS。
• 也可直接复制SSMS连接窗口中的服务器名称到连接字符串的Data Source字段。

2. 检查SQL Server服务状态 #

• 按下Win+R输入services.msc打开服务管理器，找到对应SQL Server服务，确认状态为正在运行。若未启动，右键选择启动。

3. 启用必要的网络协议 #

• 打开SQL Server配置管理器，展开SQL Server网络配置，选择对应实例的协议：
  • 确保TCP/IP或Named Pipes至少有一种处于启用状态。
  • 若启用TCP/IP，右键属性查看IP地址，确认TCP端口为默认1433，或在连接字符串中显式指定端口（如Data Source=DESKTOP-MYDESKTOP,1433）。

4. 调整Windows防火墙规则 #

• 临时关闭Windows防火墙测试连接，若能成功则需添加SQL Server服务的入站规则，允许其端口（默认1433）或程序通过防火墙。

5. 修改连接字符串参数 #

• 强制使用TCP/IP协议，添加Network Library=DBMSSOCN;参数，修改后连接字符串：

  Password=dummy;Persist Security Info=True;User ID=dummy;Initial Catalog=SomeDB;Encrypt=false;Data Source=DESKTOP-MYDESKTOP;Network Library=DBMSSOCN;
  

• 用localhost代替机器名，规避DNS解析问题：

  Password=dummy;Persist Security Info=True;User ID=dummy;Initial Catalog=SomeDB;Encrypt=false;Data Source=localhost;
  

6. 确认SQL Server身份验证模式 #

• 在SSMS中右键服务器选择属性，进入安全性选项卡，确认服务器身份验证为SQL Server和Windows身份验证模式。若之前仅设置Windows模式，修改后需重启SQL Server服务。

7. 测试基础连接 #

• 使用sqlcmd命令测试底层连接：

  sqlcmd -S DESKTOP-MYDESKTOP -U dummy -P dummy -d SomeDB
  

  若该命令成功，问题出在EF Core Scaffold命令配置；若失败，优先排查网络和SQL Server基础配置。

内容的提问来源于stack exchange，提问作者Amir Ben Shimol