EF Core连接弹性怎么配置 EF Core EnableRetryOnFailure方法

EF Core连接弹性通过EnableRetryOnFailure自动重试暂时性故障，默认6次指数退避重试，支持SQL Server/PostgreSQL/MySQL；事务需用CreateExecutionStrategy手动包装；连接字符串应配置ConnectRetryCount等参数分层防护。

EF Core 的连接弹性（Connection Resiliency）核心是自动重试因网络抖动、数据库瞬时不可用等导致的暂时性故障。最直接有效的配置方式就是使用 EnableRetryOnFailure 方法，它会为 DbContext 启用内置的重试执行策略。

基础启用方式（推荐默认用法）

对 SQL Server、PostgreSQL（Npgsql）、MySQL（Pomelo）等主流提供程序，只需在配置 DbContext 时调用 EnableRetryOnFailure() 即可启用默认策略：

• SQL Server 默认识别错误码如 40613、40197、1205 等；
• PostgreSQL 识别 08006、08001 等连接类错误；
• 默认重试次数为 6 次，延迟采用指数退避（1s → 2s → 4s → …）；
• 无需额外判断异常类型，框架自动过滤非暂时性错误（如主键冲突、语法错误）。

示例（ASP.NET Core 中注册 DbContext）：

自定义重试参数

当默认策略不满足业务场景（比如云环境波动大、或需更激进/保守的重试），可显式指定参数：

• maxRetryCount：最大重试次数（默认 6，建议设为 5–10）；
• maxRetryDelay：单次最大延迟（默认 30 秒，避免长等待阻塞请求）；
• errorNumbersToAdd：补充自定义可重试的 SQL 错误号（如 SQL Server 的 2、53、10054）；
• 注意：errorNumbersToAdd 是“追加”，不是“替换”——原有默认错误仍生效。

示例（自定义 8 次重试，最长延迟 20 秒）：

Tellers AI

Tellers是一款自动视频编辑工具，可以将文本、文章或故事转换为视频。

136

查看详情

事务中必须手动包装重试逻辑

启用了 EnableRetryOnFailure 后，普通查询和 SaveChangesAsync() 会自动重试。但一旦你显式开启事务（BeginTransactionAsync()），EF 就无法安全重试整个事务块——因为部分操作可能已提交。

• 此时若在事务内发生暂时性错误，会抛出 InvalidOperationException：“已配置的执行策略不支持用户启动的事务”；
• 正确做法：用 DbContext.Database.CreateExecutionStrategy() 获取执行策略，把整个事务逻辑包进委托里执行；
• 该策略会在失败时完整重放整个委托（含 BeginTransaction → SaveChanges → Commit），确保原子性。

连接字符串级补充配置（配合使用）

EnableRetryOnFailure 处理的是命令执行阶段的失败，而连接建立阶段的弹性还需靠连接字符串参数：

• ConnectRetryCount=5：驱动层连接尝试次数（ADO.NET 层）；
• ConnectRetryInterval=10：每次重连间隔（秒）；
• Connection Timeout=30：单次连接超时，避免卡死；
• 这两类机制（驱动层连接重试 + EF 命令重试）建议同时启用，形成双保险。

例如连接字符串片段：
Server=...;Database=...;ConnectRetryCount=5;ConnectRetryInterval=10;Connection Timeout=30;

基本上就这些。关键不是堆参数，而是理解重试边界——普通操作开箱即用，事务要手动兜底，连接建立和命令执行要分层防护。

以上就是EF Core连接弹性怎么配置 EF Core EnableRetryOnFailure方法的详细内容，更多请关注php中文网其它相关文章！