讲师中心 微信公众号
AI工具推荐 视频效率加速

Yii2的队列失败重试机制_配置TTL和重试次数【手册】

阿磊大大_5182

阿磊大大_5182

发布时间:2026-03-21 03:51:12

|

652人浏览过

|

来源于php中文网

原创

attempts 控制最大重试总次数(含首次执行),ttr 限定单次任务最长执行时间;二者需在队列组件中显式配置,否则使用默认值(attempts=0 不重试,ttr=300秒)。

yii2的队列失败重试机制_配置ttl和重试次数【手册】

yii\queue 配置 attempts 和 ttr 是怎么生效的?

Yii2 的队列重试机制不是靠“捕获异常自动重发”,而是由队列驱动(如 Redis、DB)在任务失败后,根据配置决定是否重新入队——前提是任务执行中抛出了未捕获异常,且当前重试次数未超限。

attempts 控制最大重试总次数(含首次执行),ttr(Time To Run)是单次任务最长允许执行时间,超时会被强制标记为失败并触发重试逻辑。这两个参数必须在队列组件配置里显式声明,否则使用默认值(attempts=0 表示不重试,ttr=300 秒)。

  • attempts=3 意味着:第 1 次执行失败 → 入队重试;第 2 次失败 → 再入队;第 3 次失败 → 进入 failed jobs 表(如果驱动支持),不再重试
  • ttr=60 不代表“延迟 60 秒再重试”,而是“这个任务最多运行 60 秒,超时就 kill 并当失败处理”
  • Redis 驱动下,ttr 依赖 BRPOPLPUSH + 定时扫描,DB 驱动则靠 worker 启动时的超时检查,行为略有差异

任务类里手动判断 $job->attempt 有必要吗?

没必要,除非你要做差异化逻辑——比如第 1 次失败降级调用短信,第 3 次才写日志告警。因为 Yii2 队列底层已自动在抛出异常前检查了 $queue->attempts,只要没超限,直接 throw 就会触发重试。

但要注意:$job->attempt 返回的是当前这次执行的序号(从 1 开始),不是剩余次数。它只在 job 实例中可用,且仅对当前正在执行的任务有效。

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载
  • 正确用法:if ($job->attempt
  • 错误用法:if ($job->attempt === 1) { sleep(1); } —— 这会导致首次执行人为阻塞,拖慢整个队列吞吐
  • 别在 execute() 里 try/catch 后静默 return,这等于放弃重试机会,队列认为“成功完成”

为什么设置了 attempts=3 却只重试了 1 次?

常见原因是任务没真正“失败”:你 catch 了异常但没 re-throw,或者用了 return 提前退出,又或者数据库事务 rollback 后没抛异常。队列驱动只看 execute() 方法是否以异常结束。

另一个隐蔽原因是 delay() 被误用。比如你在 job 类里写 $queue->delay(60)->push(...),这不是设置重试延迟,而是向另一个队列推新任务——和当前失败重试完全无关。

  • 重试延迟要靠驱动自身机制:Redis 队列用 retryDelay 配置项(需 yii-queue >= 2.3.0),MySQL 队列则依赖 failed_at 字段 + 定时脚本扫描
  • 检查 failed 表(或 Redis 中的 queue:failed list)是否存在记录,有则说明重试已耗尽;没有则大概率是任务被当成“成功”处理了
  • 开启 YII_DEBUG 并监听 yii\queue\JobEvent::EVENT_AFTER_EXEC,可确认每次执行的 exit status

DB 队列 vs Redis 队列,重试行为有什么实际差别?

DB 队列(如 shmilyzxt/yii2-queue)重试依赖轮询:worker 每次 fetch 时查 reserved_at IS NULL AND delayed_at IS NULL AND attempts ,所以重试间隔受 worker 启动频率影响(比如你每 5 秒跑一次 <code>php yii worker/listen,那最快也要等 5 秒才重试)。

Redis 队列(yii\queue\redis\Queue)用 BRPOPLPUSH + ZSET 维护延迟队列,能实现秒级甚至亚秒级重试,但要求 Redis 版本 ≥ 6.2 且启用 notify-keyspace-events 才能及时触发。

  • DB 方案适合低频、容忍延迟的任务(如日志归档、报表生成)
  • Redis 方案适合时效敏感场景(如通知推送、库存预占),但部署复杂度高,出问题更难排查
  • 两者都**不保证 exactly-once**,网络分区或 worker crash 可能导致重复执行,业务代码必须幂等
重试不是万能解药,逻辑错误(比如 SQL 语法错、空指针)重试多少次都没用,反而把失败任务卡在队列里占资源。真要诊断,先看 failed 表里的 error 字段,别光盯着配置数。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

4443

2023.10.12

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

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

931

2023.10.27

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

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

1169

2024.02.23

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

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

6401

2024.03.06

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

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

3203

2024.03.06

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

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

6360

2024.04.07

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

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

8701

2024.04.29

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

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

1170

2024.04.29

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii Framework 2.0 API 官方文档
Yii Framework 2.0 API 官方文档

共0课时 | 0人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.3万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn