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

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

阿磊吖_9356

阿磊吖_9356

发布时间:2026-01-02 14:29:02

|

975人浏览过

|

来源于php中文网

原创

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

在 spring cloud aws 中,通过 `@sqslistener` 的 `deletionpolicy = on_success` 配合显式异常抛出,可实现仅对指定自定义异常(如 `mycustomexception`)触发消息重试,其余异常被静默捕获,避免意外丢消息。

在使用 AWS SQS 与 Spring Cloud AWS 集成时,@SqsListener 默认行为是:只要方法执行完成(无论是否抛出异常),消息即被删除(除非显式配置 deletionPolicy)。而 SqsMessageDeletionPolicy.ON_SUCCESS 表示:仅当方法正常返回(无异常)时才自动删除消息;一旦抛出任何未捕获的异常,SQS 将保留消息并根据队列的 Visibility Timeout 和 Redrive Policy 进行重试或死信投递。

但默认情况下,所有未捕获的 RuntimeException 或 Exception 都会触发重试——这往往不符合业务需求。例如,你只希望在业务校验失败(如 MyCustomException)时重试,而对 NullPointerException、IllegalArgumentException 等编程错误或非法输入应立即记录告警、不重试、不阻塞队列,甚至可选择主动删除消息或转入死信队列(DLQ)。

✅ 正确做法是:用 try-catch 主动拦截所有异常,并有选择地重新抛出目标异常:

Aria2 Json Rpc
Aria2 Json Rpc

通过 JSON‑RPC 2.0 与 aria2 下载管理器交互,使用自然语言命令管理下载、查询状态并控制任务。适用于 aria2、下载管理或种子操作。

下载
@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(message)) {
            throw new MyCustomException("Business validation failed — retry required");
        }

        // ✅ 正常处理完成,ON_SUCCESS 触发自动删除
        log.info("Message processed successfully");

    } catch (MyCustomException e) {
        log.warn("Custom exception encountered, allowing retry", e);
        throw e; // ? 关键:仅此异常透出,触发 SQS 重试机制
    } catch (Exception e) {
        // ? 其他所有异常(NPE、IO、JSON 解析失败等)均被吞掉
        // 注意:此时方法“静默成功返回”,ON_SUCCESS 生效 → 消息被删除!
        log.error("Unexpected error — message will be deleted (not retried)", e);
        // 可选:在此处主动发送告警、记录到审计表、或调用 SQS deleteMessage(需 accessKey)
    }
}

⚠️ 重要注意事项:

  • ON_SUCCESS 不等于“零丢失”:它仅保证 成功路径 删除消息;但若因 JVM 崩溃、容器重启等导致方法未返回,消息仍会因 Visibility Timeout 超时而重回队列(这是 SQS 自身保障机制)。
  • 吞掉异常 ≠ 安全:catch(Exception) 吞掉非自定义异常虽防止了无效重试,但也掩盖了潜在 Bug。务必配合完善的日志、监控(如 Prometheus + Grafana)、错误追踪(如 Sentry)和告警。
  • 避免空 catch 块:示例中 catch(Exception) 内必须包含明确的日志级别(error)和上下文,禁止 catch(Exception e) {}。
  • 考虑 DLQ 最佳实践:对于反复失败的 MyCustomException(如连续 3 次),建议配置 SQS Redrive Policy 指向 DLQ,便于人工介入分析,而非无限循环重试。
  • Spring Cloud AWS 版本兼容性:确保使用 spring-cloud-aws-messaging:2.4+ 或 spring-cloud-aws-starter-sqs:3.0+,旧版本 API(如 SqsMessageDeletionPolicy 枚举位置)可能存在差异。

总结:精准控制 SQS 重试的核心在于 “异常分类治理” —— 用 try-catch 显式区分业务可重试异常与系统不可重试异常,并严格匹配 deletionPolicy 行为。这既保障了业务语义的准确性,又避免了因泛化异常处理导致的消息堆积或数据丢失风险。

热门AI工具

更多
豆包大模型

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

DeepSeek

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

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

Seko
Seko Hot

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

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

讯飞智作

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

WorkBuddy

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

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2211

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

417

2026.01.26

Java 微服务与 Spring Cloud 实战
Java 微服务与 Spring Cloud 实战

本专题讲解 Java 微服务架构的开发与实践,重点使用 Spring Cloud 实现服务注册与发现、负载均衡、熔断与限流、分布式配置管理、API Gateway 和消息队列。通过实际项目案例,帮助开发者理解 如何将传统单体应用拆分为高可用、可扩展的微服务架构,并有效管理和调度分布式系统中的各个组件。

308

2026.02.05

Java Spring Cloud微服务配置中心与服务治理实践
Java Spring Cloud微服务配置中心与服务治理实践

本专题围绕 Java 微服务体系中的配置管理与服务治理展开,重点讲解 Spring Cloud 在分布式系统中的核心组件应用。内容涵盖配置中心设计、服务注册与发现、负载均衡、熔断降级以及分布式配置动态刷新机制。通过实际项目案例,帮助开发者构建高可用、易扩展的微服务架构体系。

234

2026.04.07

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

889

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2420

2023.10.25

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

4747

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2148

2023.08.10

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 20.6万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.7万人学习

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

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