为何HttpRequestMessage.SetPolicyExecutionContext无法向Polly策略传递上下文？

核心原因 #

SetPolicyExecutionContext 是Polly专门为HttpClientFactory集成场景设计的扩展方法，并非Polly原生策略执行流程的一部分。只有通过HttpClientFactory为HttpClient附加Polly策略时，底层的PollyHttpClientMessageHandler才会自动读取HttpRequestMessage上的上下文并传递给策略；直接调用策略的ExecuteAsync方法时，Polly不会主动读取这个属性。

具体场景分析 #

1. HttpClientFactory集成场景生效的逻辑 #

当你使用AddPolicyHandler这类方法通过HttpClientFactory为HttpClient绑定策略时：

• HttpClient发送请求时，会被PollyHttpClientMessageHandler拦截
• 该处理程序会调用request.GetPolicyExecutionContext()提取你设置的上下文
• 随后将上下文传递给关联的Polly策略执行，因此OnRetry委托中能正常获取上下文值

2. Case1失效的原因 #

直接调用policy.ExecuteAsync(() => _httpClient.SendAsync(request))时：

• Polly的策略执行逻辑只会使用显式传入的上下文（调用带context参数的重载时），或创建空的默认上下文
• 它完全不知道HttpRequestMessage上存在PolicyExecutionContext附加属性，自然不会去读取，因此OnRetry中拿不到你设置的"X"键值

3. Case2生效的原因 #

Case2使用了ExecuteAsync的重载：policy.ExecuteAsync((token) => _httpClient.SendAsync(request), context)

• 这是Polly策略执行的标准用法，你显式将上下文传递给了策略
• 策略执行时会直接使用该上下文，因此OnRetry中能正常获取"myKey"对应的"ABC"值

替代方案（直接调用策略时关联请求上下文） #

如果想在直接调用策略的场景下，复用SetPolicyExecutionContext的方式传递上下文，可以封装一个扩展方法，手动提取请求上下文并传给策略：

using Polly;
using System.Net.Http;
using System.Threading;
using System.Threading.Tasks;

public static class PollyHttpRequestExtensions
{
    public static Task<HttpResponseMessage> ExecuteWithRequestContextAsync(
        this IAsyncPolicy<HttpResponseMessage> policy,
        HttpRequestMessage request,
        HttpClient client,
        CancellationToken cancellationToken = default)
    {
        // 从请求中提取上下文，无上下文则创建默认实例
        var context = request.GetPolicyExecutionContext() ?? new Context();
        return policy.ExecuteAsync(token => client.SendAsync(request, token), context, cancellationToken);
    }
}

调用方式：

var context = new Context();
context.Add("X", "ABC");
request.SetPolicyExecutionContext(context);
await policy.ExecuteWithRequestContextAsync(request, _httpClient);

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