在分布式
系统与微服务架构日益普及的今天，网络抖动、临时性服务不可用、
数据库连接超时等瞬态故障（Transient Faults）已成为常态。面对这类非永久性错误，
简单抛出异常或直接失败往往不是最优解——更优雅的方式是引入
智能重试机制。本文聚焦 C# 开发中重试逻辑的
设计与实现，以编号为 `c#_1_3_6a1510aef0c884.59067727` 的实践案例为线索，探讨如何构建可配置、可观测、且不掩盖真实问题的重试策略。
初学者常以“while + try-catch”手写重试循环，例如：
```csharp
int attempt = 0;
while (attempt < 3)
{
try
{
var result = await httpClient.
GETAsync("
https://
api.ex
ample.
com/data");
return await result.Content.ReadAsStringAsync();
}
catch (HttpRequestException)
{
attempt++;
if (attempt == 3) throw;
await Task.Delay(1000);
}
}
```
这段
代码虽能工作，却存在明显缺陷：硬编码重试次数与延迟、无法区分可重试与不可重试异常（如 401 Unauthorized 不应重试）、缺乏退避策略（固定1秒延迟易引发雪崩），更无上下文追踪能力。
真正的工程化重试需满足三大原则：**可识别性**（精准捕获瞬态异常）、**可退避性**（指数退避+随机抖动）、**可审计性**（
记录每次重试的耗时、原因与结果）。.NET 生态为此提供了成熟支持。`Polly` 库是行业事实标准，其声明式语法让重试策略清晰可读：
```csharp
var retryPolicy = Policy
.Handle
()
.OrResult(r => !r.IsSuccessStatusCode && r.StatusCode is not (System.Net.HttpStatusCode.Unauthorized or HttpStatusCode.Forbidden))
.WaitAndRetryAsync(
retryCount: 3,
sleepDurationProvider: retryAttempt => TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)) + TimeSpan.FromMilliseconds(Random.Shared.Next(100, 500)),
onRetry: (outcome, timespan, retryCount, context) =>
{
Console.WriteLine($"第{retryCount}次重试，延迟{timespan.TotalSeconds:F1}s，原因：{outcome.Exception?.Message ?? outcome.Result?.StatusCode.ToString()}");
});
```
此处融合了指数退避（2ⁿ秒）与随机抖动（100–500ms），避免重试请求同步冲击下游；同时通过 `OrResult` 精确过滤 HTTP 状态码，将认证失败等语义化错误排除在重试范围之外。
值得注意的是，重试并非万能解药。在 `c#_1_3_6a1510aef0c884.59067727` 这一真实项目中，团队曾因盲目重试导致数据重复提交——根源在于上游接口未实现幂等性。因此，重试前必须确认操作是否具备幂等性（如 GET/HEAD 安全，而 POST 需配合唯一请求 ID）。我们随后在调用层强制注入 `X-Request-ID` 头，并在重试策略中绑定 `Context` 传递该标识，使日志可追溯同一逻辑请求的所有尝试：“`[c#_1_3_6a1510aef0c884.59067727] req-id=abc123, attempt=2, status=503`”。
此外，.NET 8 新增的 `HttpClientFactory` 内置重试支持（`AddStandardResilienceHandler()`）进一步降低了门槛，但其默认策略仍需按场景调整。我们建议：对内部服务调用启用轻量重试（2次+线性退避），对外部第三方 API 则保守设置（1次+长延迟），并始终启用熔断器（Circuit Breaker）作为兜底保护。
最后，请谨记：重试是容错手段，而非错误处理替代品。每一次重试都应伴随监控告警（如 PromeTheus 指标 `http_client_retries_total{policy="external_api"}`），并在日志中保留原始异常堆栈。当重试失败率持续高于阈值时，系统应触发自动降级或人工告警——这正是 `c#_1_3_6a1510aef0c884.59067727` 案例中沉淀的关键经验：**健壮的重试，始于对失败的敬畏，成于对边界的清醒认知。**
