0

0

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

碧海醫心

碧海醫心

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

|

955人浏览过

|

来源于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 主动拦截所有异常,并有选择地重新抛出目标异常

腾讯交互翻译
腾讯交互翻译

腾讯AI Lab发布的一款AI辅助翻译产品

下载
@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

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

156

2025.08.06

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

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

88

2026.01.26

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

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

51

2026.02.05

scripterror怎么解决
scripterror怎么解决

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

492

2023.10.18

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

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

382

2023.10.25

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

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

443

2023.07.18

堆和栈区别
堆和栈区别

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

605

2023.08.10

Grafana重置admin密码
Grafana重置admin密码

本专题整合了grafana admin密码相关教程,阅读专题下面的文章了解更多详细内容。

50

2025.09.02

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

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

精品课程

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

共101课时 | 10.1万人学习

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

共39课时 | 3.3万人学习

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

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