AWS SQS 消息失败重试策略:仅对自定义异常触发重试

发布时间 - 2026-01-02 00:00:00    点击率:

在 spring cloud aws 中,通过 `@sqslistener` 配合 `on_success` 删除策略时,需手动捕获非目标异常,仅让特定自定义异常(如 `mycustomexception`)向上抛出以触发消息重试,其余异常应静默吞并或记录,避免意外丢消息。

当使用 SqsMessageDeletionPolicy.ON_SUCCESS 时,SQS 消息仅在方法正常返回(无异常)时自动删除;一旦方法抛出任何未捕获的异常,Spring 将默认执行失败处理逻辑(如将消息放回队列或进入死信队列,取决于 SQS 的 RedrivePolicy 和 VisibilityTimeout 设置)。但问题核心在于:我们不希望所有异常都触发重试——例如 NullPointerException 或 IllegalArgumentException 往往代表代码缺陷或数据脏污,应被拦截并记录,而非盲目重试,否则可能造成重复处理、状态不一致甚至死循环。

✅ 正确做法是:用 try-catch 显式包裹业务逻辑,仅重新抛出白名单内的自定义异常(如 MyCustomException),其他异常则统一捕获、记录日志,并不抛出,从而让方法“静默成功”退出,使 SQS 按 ON_SUCCESS 策略删除该消息(即视为已处理完毕,不再重试)。

以下是推荐实现:

@SqsListener(
    value = "https://sqs.us-east-1.amazonaws.com/123456789012/MyQueueURL",
    deletionPolicy = SqsMessageDeletionPolicy.ON_SUCCESS
)
public void getMessageFromSqs(MyMessage message) {
    try {
        log.info("Processing message: {}", message);

        if (someCondition()) {
            throw new MyCustomException("Business rule violated — retry required");
        }

        // ✅ 业务逻辑成功完成
        log.info("Message processed successfully");

    } catch (MyCustomException e) {
        log.warn("Custom exception encountered, allowing retry", e);
        throw e; // ? 关键:仅此异常透出,触发 SQS 重试
    } catch (Exception e) {
        // ⚠️ 兜底捕获:所有其他异常(NPE、JSON parse error、DB timeout 等)
        log.error("Unexpected error — suppressing to avoid unintended retry", e);
        // 不抛出 → 方法正常结束 → ON_SUCCESS 生效 → 消息被删除
    }
}

? 关键注意事项:

  • 勿滥用静默吞并:catch (Exception e) 吞并所有异常虽可防止误重试,但也掩盖了潜在 Bug。务必确保 log.error 包含完整堆栈,并接入告警系统(如 CloudWatch Alarms + Slack)。
  • 自定义异常需继承 RuntimeException:Spring 的异常传播机制默认只对 RuntimeException 及其子类触发重试行为(检查 SqsMessagingTemplate 默认错误处理器逻辑)。
  • 配合 SQS 队列配置:确保队列设置了合理的 VisibilityTimeout(大于方法最大执行耗时)和 maxReceiveCount(配合 DLQ 使用),避免因超时导致重复投递。
  • 幂等性仍是基石:即使精准控制重试,消费者端仍必须实现幂等设计(如基于 messageId 或业务唯一键去重),因为网络抖动、实例重启等场景仍可能导致重复消息。

总结:ON_SUCCESS 是一种“乐观删除”策略,它把失败判定权完全交还给开发者。通过精细的异常分类与受控抛出,你能在保障系统健壮性的同时,实现语义清晰、可运维的消息重试边界。


# js  # json  # 处理器  #   # win  # red  # spring  # spring cloud  # 子类  # try  # catch  # Error  # 循环  # 继承  #   # bug  # 重试  # 抛出  # 自定义  # 是一种  # 能在  # 但也  # 仍是  # 而非  # 重启 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Windows驱动无法加载错误解决方法_驱动签名验证失败处理步骤  如何制作一个表白网站视频,关于勇敢表白的小标题?  Laravel如何实现多语言支持_Laravel本地化与国际化(i18n)配置教程  国美网站制作流程,国美电器蒸汽鍋怎么用官方网站?  创业网站制作流程,创业网站可靠吗?  *服务器网站为何频现安全漏洞?  如何使用 Go 正则表达式精准提取括号内首个纯字母标识符(忽略数字与嵌套)  Laravel辅助函数有哪些_Laravel Helpers常用助手函数大全  node.js报错:Cannot find module 'ejs'的解决办法  Laravel怎么使用Blade模板引擎_Laravel模板继承与Component组件复用【手册】  如何快速重置建站主机并恢复默认配置?  谷歌浏览器下载文件时中断怎么办 Google Chrome下载管理修复  东莞专业网站制作公司有哪些,东莞招聘网站哪个好?  Laravel如何实现API资源集合?(Resource Collection教程)  Laravel怎么调用外部API_Laravel Http Client客户端使用  使用豆包 AI 辅助进行简单网页 HTML 结构设计  佐糖AI抠图怎样调整抠图精度_佐糖AI精度调整与放大细化操作【攻略】  进行网站优化必须要坚持的四大原则  头像制作网站在线观看,除了站酷,还有哪些比较好的设计网站?  Laravel如何处理和验证JSON类型的数据库字段  专业型网站制作公司有哪些,我设计专业的,谁给推荐几个设计师兼职类的网站?  1688铺货到淘宝怎么操作 1688一键铺货到自己店铺详细步骤  Laravel如何编写单元测试和功能测试?(PHPUnit示例)  网站图片在线制作软件,怎么在图片上做链接?  如何在万网自助建站中设置域名及备案?  如何用JavaScript实现文本编辑器_光标和选区怎么处理  Laravel如何使用Livewire构建动态组件?(入门代码)  Laravel如何使用withoutEvents方法临时禁用模型事件  QQ浏览器网页版登录入口 个人中心在线进入  详解CentOS6.5 安装 MySQL5.1.71的方法  Laravel Eloquent性能优化技巧_Laravel N+1查询问题解决  猎豹浏览器开发者工具怎么打开 猎豹浏览器F12调试工具使用【前端必备】  如何自定义safari浏览器工具栏?个性化设置safari浏览器界面教程【技巧】  实例解析Array和String方法  学生网站制作软件,一个12岁的学生写小说,应该去什么样的网站?  图片制作网站免费软件,有没有免费的网站或软件可以将图片批量转为A4大小的pdf?  矢量图网站制作软件,用千图网的一张矢量图做公司app首页,该网站并未说明版权等问题,这样做算不算侵权?应该如何解决?  Laravel Admin后台管理框架推荐_Laravel快速开发后台工具  百度浏览器如何管理插件 百度浏览器插件管理方法  INTERNET浏览器怎样恢复关闭标签页_INTERNET浏览器标签恢复快捷键与方法【指南】  Laravel如何生成PDF或Excel文件_Laravel文档导出工具与使用教程  再谈Python中的字符串与字符编码(推荐)  为什么php本地部署后css不生效_静态资源加载失败修复技巧【技巧】  JavaScript Ajax实现异步通信  如何快速搭建二级域名独立网站?  详解Nginx + Tomcat 反向代理 如何在高效的在一台服务器部署多个站点  公司网站制作需要多少钱,找人做公司网站需要多少钱?  米侠浏览器网页背景异常怎么办 米侠显示修复  DeepSeek是免费使用的吗 DeepSeek收费模式与Pro版本功能详解  jquery插件bootstrapValidator表单验证详解