如何在EF6中复现Execution Timeout Expired执行超时错误？

先明确两个超时的区别 #

你之前混淆了连接超时和命令超时：

• Connection Timeout：仅控制建立数据库连接的超时时间，和SaveChanges执行SQL语句的时间无关，所以修改连接字符串里的这个参数没用。
• CommandTimeout：才是控制SQL命令（比如批量插入/更新语句）执行的超时时间，这才是你需要调整的目标。

针对不同EF版本的正确设置方式 #

1. EF6环境 #

• 全局设置（上下文构造函数）：确保构造函数中的设置生效，代码示例：

  public class AppDbContext : DbContext
  {
      public AppDbContext() : base("YourConnectionStringName")
      {
          Database.CommandTimeout = 2; // 设置为2秒超时
      }
  }
  

• 临时设置（单次操作）：必须在SaveChanges执行前设置，避免上下文被其他逻辑覆盖：

  using (var context = new AppDbContext())
  {
      // 将Excel数据映射为实体集合
      context.TargetEntities.AddRange(largeEntityList);
      // 必须在SaveChanges之前设置
      context.Database.CommandTimeout = 2;
      context.SaveChanges();
  }
  

2. EF Core环境 #

EF Core的设置方法略有不同，推荐两种方式：

• 全局配置（Startup/Program.cs）：

  services.AddDbContext<AppDbContext>(options =>
      options.UseSqlServer(Configuration.GetConnectionString("YourConnection"),
          sqlOptions => sqlOptions.CommandTimeout(2)));
  

• 临时设置（单次操作）：

  using (var context = new AppDbContext())
  {
      context.TargetEntities.AddRange(largeEntityList);
      // EF Core用SetCommandTimeout方法
      context.Database.SetCommandTimeout(2);
      context.SaveChanges();
  }
  

排查设置不生效的常见原因 #

• 检查是否存在嵌套上下文实例：如果代码中创建了多个上下文对象，或者其他逻辑重置了CommandTimeout，会导致你的设置失效。
• 检查是否使用了第三方批量操作库：比如EntityFramework.BulkInsert这类库，它们会绕过EF原生的命令超时设置，需要单独配置库的超时参数。
• 数据库层面的remote query timeout：默认是600秒（10分钟），仅针对远程查询生效，本地测试一般不需要修改。如果要临时调整，可在SSMS执行：

  -- 查看当前设置
  SELECT name, value_in_use FROM sys.configurations WHERE name = 'remote query timeout (s)'
  -- 临时改为5秒（测试后改回默认）
  sp_configure 'remote query timeout', 5;
  RECONFIGURE;
  

快速复现超时的技巧 #

如果本地数据量不够大，可以手动给目标表加锁模拟超时：
在SSMS中执行以下语句（不要提交事务）：

BEGIN TRANSACTION;
SELECT * FROM TargetTableName WITH (TABLOCKX);

然后运行你的导入代码，此时SaveChanges会因无法获取锁而快速触发超时错误。

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