0

0

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

月夜之吻

月夜之吻

发布时间:2025-12-19 11:46:46

|

133人浏览过

|

来源于php中文网

原创

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

ef core连接弹性怎么配置 ef core enableretryonfailure方法

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):

services.AddDbContext(options =>
  options.UseSqlServer(connectionString, sqlOptions =>
    sqlOptions.EnableRetryOnFailure()));

自定义重试参数

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

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

示例(自定义 8 次重试,最长延迟 20 秒):

星火作家大神
星火作家大神

星火作家大神是一款面向作家的AI写作工具

下载
options.UseSqlServer(conn, o => o.EnableRetryOnFailure(
  maxRetryCount: 8,
  maxRetryDelay: TimeSpan.FromSeconds(20),
  errorNumbersToAdd: new[] { 2, 53 }));

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

启用了 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;

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

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

683

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

323

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

348

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

1096

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

358

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

697

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

577

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

418

2024.04.29

AO3中文版入口地址大全
AO3中文版入口地址大全

本专题整合了AO3中文版入口地址大全,阅读专题下面的的文章了解更多详细内容。

1

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 1.9万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 805人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号