Entity Framework Code First应用迁移至SQL Server连接失败排查

遇到这种情况太常见了，别着急，咱们一步步拆解问题，从最容易出错的地方开始排查：

一、先把连接字符串的细节核对清楚 #

你说修改了连接字符串，但很可能是细节没到位：

• 服务器实例名要准确：目标电脑的SQL Server如果是默认实例，写(local)或者.就行；如果是命名实例（比如SQLEXPRESS），得写成.\SQLEXPRESS或者目标电脑名\实例名——直接去目标电脑的SSMS里抄服务器名称最靠谱。
• 认证方式别搞混：用Windows身份验证的话，连接字符串里必须有Integrated Security=True；如果用SQL Server账号登录，要加上User ID=你的账号;Password=你的密码;，而且得确保这个账号有你手动创建的数据库的读写权限。
• 数据库名称要完全匹配：哪怕大小写差一点，都可能出问题，仔细核对你手动建的库名和连接字符串里的是不是完全一致。
• 别忘了指定providerName：app.config里的connectionStrings节点下，一定要加上providerName="System.Data.SqlClient"（.NET Framework）或者Microsoft.Data.SqlClient（.NET Core/5+），EF全靠这个识别数据库提供者呢。

给你个标准的.NET Framework连接字符串示例参考：

<connectionStrings>
  <add name="YourDbContextName" 
       connectionString="Server=(local);Database=YourDatabaseName;Integrated Security=True;" 
       providerName="System.Data.SqlClient" />
</connectionStrings>

二、关闭EF的自动初始化策略（关键！） #

你是手动创建了数据库表，但Code First默认的初始化逻辑会尝试创建/修改数据库，这很可能和你手动建的表冲突，导致连接失败。必须把自动初始化关掉，或者改成只验证模型匹配：

方法1：在DbContext构造函数里设置 #

public class YourDbContext : DbContext
{
    public YourDbContext() : base("name=YourDbContextName")
    {
        // 完全关闭自动初始化，避免EF瞎改数据库
        Database.SetInitializer<YourDbContext>(null);
        // 如果想验证模型和数据库结构是否匹配，就用下面这句替代：
        // Database.SetInitializer(new ValidateDatabaseSchema<YourDbContext>());
    }

    // 这里放你的DbSet定义，比如 public DbSet<User> Users { get; set; }
}

方法2：在app.config里配置 #

<entityFramework>
  <contexts>
    <context type="你的命名空间.YourDbContext, 你的程序集名称">
      <databaseInitializer type="System.Data.Entity.NullDatabaseInitializer`1[[你的命名空间.YourDbContext, 你的程序集名称]], EntityFramework" />
    </context>
  </contexts>
</entityFramework>

三、先抛开EF，验证基础连接是否正常 #

有时候问题根本不在EF，而是SQL Server本身的配置问题。咱们先绕开EF，直接测试数据库连接：

• 打开目标电脑的命令提示符，运行：sqlcmd -S 你的服务器名 -d 你的数据库名 -E（Windows身份验证），如果能进入sqlcmd的交互模式，说明基础连接是通的；如果用SQL账号，就换成sqlcmd -S 你的服务器名 -d 你的数据库名 -U 用户名 -P 密码。
• 如果这一步连不上，那就是SQL Server的配置问题：
  • 先检查SQL Server服务有没有启动：去「服务」里找SQL Server (你的实例名)，确保它是运行状态。
  • 检查是否启用了TCP/IP协议：打开SQL Server配置管理器，找到你的实例的「网络配置」，启用TCP/IP，然后重启SQL Server服务。
  • 看看防火墙有没有挡着：可以临时关闭Windows防火墙测试，如果能连上了，再给SQL Server的默认端口（1433）添个防火墙允许规则。

四、核对EF版本和依赖 #

确保目标电脑上的EF版本和你开发环境的完全一致，比如你用的是EF6，就别让目标电脑装成EF5了。最稳妥的办法是把项目里所有依赖的dll（包括EF的相关文件）都设置为「复制本地」=True，这样部署的时候直接把整个应用目录拷过去，就不会缺依赖了。

五、抓具体的错误信息，别只看“无法连接” #

模糊的错误提示没用，得抓详细的异常堆栈：
在应用启动的地方加个异常捕获，比如：

try
{
    using(var db = new YourDbContext())
    {
        // 随便查个表测试连接
        var testData = db.Users.FirstOrDefault();
        Console.WriteLine("数据库连接成功！");
    }
}
catch(Exception ex)
{
    // 把错误信息打出来，或者写到日志里
    Console.WriteLine("错误详情：\n" + ex.ToString());
}

根据具体的错误信息（比如“模型与数据库不匹配”“权限不足”“服务器找不到”），就能精准定位问题了。

内容的提问来源于stack exchange，提问作者Jiří Vrbas