EntityFramework Core 6连接超时设置无效，如何复现超时错误？

一、现有设置无效的原因 #

你之前的操作混淆了连接超时和命令超时的概念，同时忽略了EF Core批量操作的默认行为：

1. 连接字符串中的Connection Timeout=1不生效 #

这个参数控制的是建立数据库连接的超时时间，仅在程序首次连接数据库时生效。你的代码是在已经成功连接数据库后执行数据插入，因此该设置不会影响SaveChanges()的执行超时。

2. 命令超时设置未触发的核心原因：EF Core的批量分批次提交 #

EF Core 6默认会将大量插入操作拆分为多个小批次执行（默认批次大小为42），每一批次的插入耗时远小于你设置的1-5秒超时阈值。即使整体插入耗时10秒，但单个批次的执行时间都在超时时间内，因此不会触发命令超时错误。

二、成功复现超时错误的方法 #

方法1：强制单批次提交所有数据 #

修改EF Core的批量提交配置，让25万条数据一次性提交，这样单条命令的执行时间会超过你设置的超时阈值，从而触发错误。

配置方式1：在DI注册DbContext时设置

options.UseSqlServer("Data Source=.\SQLEXPRESS;Initial Catalog=TESTOWISKO;Integrated Security=True;MultipleActiveResultSets=true",
    sqlServerOptions => 
    {
        sqlServerOptions.CommandTimeout(1); // 设置命令超时为1秒
        sqlServerOptions.MaxBatchSize(250000); // 强制所有数据单批次提交
    });

配置方式2：在DbContext的OnModelCreating中设置

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 针对Person实体设置单批次提交
    modelBuilder.Entity<Person>().ToTable(b => b.HasMaxBatchSize(250000));
}

方法2：人为增加数据库执行延迟 #

如果不想修改批次大小，可以通过以下方式让数据库执行插入的时间变长：

• 在Person表上创建一个触发器，每次插入时添加WAITFOR DELAY '00:00:02'（延迟2秒），这样每个批次的执行时间都会超过1秒的超时设置。
• 在插入数据前启动一个长时间运行的事务，占用数据库资源，拖慢插入操作的执行速度。

验证命令超时设置是否生效 #

可以在SaveChanges()前添加代码，确认当前命令超时是否正确设置：

Console.WriteLine($"当前命令超时：{_context.Database.GetCommandTimeout()}");
_context.SaveChanges();

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