Failsafe库中实现请求重试时动态修改请求头的最佳实践

在分布式系统开发中，请求重试是一个常见的容错机制。Failsafe作为一个轻量级的Java库，提供了强大的重试和容错功能。本文将深入探讨如何在Failsafe重试机制中动态修改请求头，特别是针对需要为每次重试生成唯一追踪ID的场景。

问题背景

在微服务架构中，我们经常需要为每个请求添加唯一的追踪ID（如x-tracking-id），以便在分布式系统中跟踪请求链路。当使用Failsafe进行请求重试时，如果简单地复用同一个请求对象，会导致所有重试请求共享相同的追踪ID，这会给监控和问题排查带来困难。

解决方案

基本实现方式

最直接的解决方案是将请求构建逻辑移动到重试执行的lambda表达式内部：

Response response = Failsafe.with(retryPolicy)
    .get(() -> {
        Request req = buildRequestWithNewTrackingId(); // 每次重试都构建新请求
        return handleRequest(req);
    });

这种方式确保每次重试都会生成全新的请求对象，自然包含了新的追踪ID。

利用执行上下文

如果需要根据重试上下文信息来构建请求，可以使用Failsafe提供的ExecutionContext：

Response response = Failsafe.with(retryPolicy)
    .get(ctx -> {
        Request req = buildRequest(ctx.getAttemptCount()); // 根据重试次数构建请求
        return handleRequest(req);
    });

性能优化方案

如果请求构建成本较高，可以采用"修改已有请求"的模式：

Request baseRequest = buildBaseRequest(); // 构建基础请求

Response response = Failsafe.with(retryPolicy)
    .get(ctx -> {
        Request currentReq = cloneAndModifyRequest(baseRequest, ctx);
        return handleRequest(currentReq);
    });

设计思考

这种设计模式体现了几个重要的软件设计原则：

1. 单一职责原则：将请求构建逻辑与重试逻辑分离
2. 不变性原则：每次重试使用独立的请求对象，避免副作用
3. 可观测性原则：确保每个重试请求都有唯一标识，便于监控

实际应用建议

在实际项目中，建议：

1. 为追踪ID生成封装独立的方法，确保生成逻辑一致
2. 考虑使用线程安全的UUID生成器
3. 对于HTTP客户端，可以利用拦截器模式自动添加追踪ID
4. 记录重试次数和原始追踪ID，便于关联分析

总结

通过将请求构建逻辑纳入重试执行体，我们能够优雅地实现每次重试使用不同请求头的需求。这种模式不仅适用于追踪ID场景，也可以扩展到其他需要在重试时修改请求参数的用例。Failsafe的灵活性使得这类需求可以很自然地实现，而不需要复杂的扩展或自定义代码。