Spring Boot Retry：如何保留首次异常信息

核心思路：提前捕获并持久化首次异常 #

无论用原生代码实现重试还是借助框架，核心都是在第一次出现异常时就把它存下来，后续重试产生的新异常只做日志记录，不覆盖首次异常，最终重试耗尽时优先抛出或展示首次异常。

具体实现方案 #

1. 原生代码手动记录

在重试循环里初始化一个变量专门存储首次异常，第一次捕获到异常时赋值，后续重试只更新重试状态，不修改这个变量。最终失败时抛出首次异常，同时可以保留异常链方便排查。

Python示例：

import random

def business_operation():
    # 模拟可能抛出不同异常的业务操作
    if random.random() < 0.5:
        raise ValueError("首次执行：参数格式错误")
    else:
        raise ConnectionError("重试时：网络连接超时")

def retry_operation(max_retries=3):
    first_err = None
    for attempt in range(max_retries + 1):
        try:
            return business_operation()
        except Exception as e:
            if first_err is None:
                first_err = e
            if attempt == max_retries:
                # 抛出首次异常，同时保留后续异常的上下文
                raise first_err from e
            print(f"第{attempt+1}次重试失败，当前错误：{str(e)}")

try:
    retry_operation()
except Exception as e:
    print(f"最终执行失败，根源错误：{str(e)}")
    # 若需要查看完整异常链，可以打印traceback
    import traceback
    traceback.print_exc()

2. 借助重试框架的扩展能力

主流重试框架（如Java Spring Retry、Guava Retry）都提供了异常监听或钩子机制，可以在重试生命周期中记录首次异常。

Java Spring Retry示例：

import org.springframework.retry.RetryCallback;
import org.springframework.retry.RetryContext;
import org.springframework.retry.RetryListener;
import org.springframework.retry.support.RetryTemplate;

public class RetryFirstErrorDemo {
    private static Throwable firstException;

    public static void main(String[] args) {
        RetryTemplate retryTemplate = new RetryTemplate();
        // 注册重试监听器，记录首次异常
        retryTemplate.registerListener(new RetryListener() {
            @Override
            public <T, E extends Throwable> boolean open(RetryContext context, RetryCallback<T, E> callback) {
                firstException = null;
                return true;
            }

            @Override
            public <T, E extends Throwable> void onError(RetryContext context, RetryCallback<T, E> callback, Throwable throwable) {
                if (firstException == null) {
                    firstException = throwable;
                }
            }
        });

        try {
            retryTemplate.execute(context -> {
                // 模拟业务操作
                if (Math.random() < 0.5) {
                    throw new IllegalArgumentException("首次执行：参数非法");
                } else {
                    throw new RuntimeException("重试时：服务内部错误");
                }
            });
        } catch (Exception e) {
            // 优先使用首次异常作为根源错误
            Throwable rootErr = firstException != null ? firstException : e;
            System.out.println("最终失败，根源错误：" + rootErr.getMessage());
        }
    }
}

3. 封装通用重试工具类

如果需要在多个业务场景复用，可以封装一个通用的重试工具类，内部统一处理首次异常的记录逻辑，对外只暴露重试配置和业务方法。

关键注意事项 #

• 保留异常链：使用语言自带的异常链机制（如Python的raise ... from ...、Java的initCause），既能突出首次异常，也能保留后续重试的异常信息，便于完整回溯问题。
• 日志完整性：每次重试失败时，同时记录当前异常和首次异常的信息，方便日志分析时了解整个重试过程的错误变化。
• 内存管理：如果重试逻辑是长期运行的任务，要确保首次异常对象在重试结束后能被正确回收，避免不必要的内存占用。

内容的提问来源于stack exchange，提问作者tony