.NET6 C# Web API连接Azure SQL Server超时问题求助

1. 区分连接超时与命令超时 #

你遇到的30秒超时可能分为两类场景：

• 连接超时：与Azure SQL Server建立网络连接阶段的超时，默认通常为15或30秒
• 命令超时：SQL语句执行过程中的超时，你在构造函数里设置的Database.SetCommandTimeout(230)仅针对这类场景

构造函数中设置命令超时的问题在于：池化的DbContext实例在执行base(options)初始化时，可能已经触发模型验证、连接预测试等操作，此时命令超时配置尚未生效，导致部分操作仍沿用默认30秒限制。

2. 在DbContext配置阶段直接指定超时参数 #

跳过构造函数设置，直接在AddDbContextPool的配置流程中定义命令超时和连接超时，让所有池化的DbContext实例从创建之初就使用正确的超时规则：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContextPool<MyContext>(options => 
    options.UseSqlServer(ConnStr, sqlOptions => 
    {
        sqlOptions.CommandTimeout(230); // 全局设置命令执行超时
        sqlOptions.ConnectTimeout(300); // 设置连接阶段超时（可根据Azure允许值调整）
    })
);
var app = builder.Build();

3. 优化连接字符串配置 #

在连接字符串中明确指定连接超时和连接池参数，进一步降低连接阶段的超时风险：

Server=tcp:your-server.database.windows.net,1433;Initial Catalog=your-db;Persist Security Info=False;User ID=your-user;Password=your-pass;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=300;Max Pool Size=100;

• Connection Timeout=300：将连接超时设为5分钟（Azure SQL支持的最大值）
• Max Pool Size=100：调整连接池容量，避免因池耗尽导致的等待超时

4. 池化DbContext的额外优化 #

• 避免在MyContext的构造函数或OnConfiguring方法中执行耗时操作，这类操作会在池化实例初始化时触发，增加超时概率
• 若实体模型较大，可使用EF Core 6+支持的预编译模型，减少首次DbContext初始化的开销：

  // 在MyContext中定义静态模型构建器
  public static readonly ModelBuilder ModelBuilder = new();
  static MyContext()
  {
      // 在这里配置所有实体映射规则
      ModelBuilder.Entity<YourEntity>();
  }
  
  // 配置服务时使用预编译模型
  builder.Services.AddDbContextPool<MyContext>(options => 
      options.UseSqlServer(ConnStr, sqlOptions => 
          sqlOptions.UseModel(MyContext.ModelBuilder.FinalizeModel())
      )
  );
  

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