在WebForms中执行任务式异步工作时如何保留HttpContext访问权限

问题描述 #

维护基于.NET Framework 4.8的遗留WebForms应用，部分代码采用异步实现，依赖NHibernate（会话存储在HttpContext中）。但在Task.Run的委托内HttpContext.Current为null，导致NHibernate的WebSessionContext无法正确获取请求对应的会话。

当前web.config已配置：

• <httpRuntime targetFramework="4.8" />
• <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" />

已知理想方案是在请求开始时获取会话并显式传递，但受限于现有代码结构无法大范围修改，需要找到无需大量改动即可保留HttpContext访问权的方法。

示例问题代码：

public partial class Test : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        // 此处HttpContext存在
        var a = System.Web.HttpContext.Current;

        var asyncTask = new System.Web.UI.PageAsyncTask(() => {

            // 此处HttpContext仍存在
            var b = System.Web.HttpContext.Current;

            return Task.Run(() => {

                // 此处HttpContext.Current为null
                var c = System.Web.HttpContext.Current;

                // 模拟业务操作
                return Task.Delay(5000);
            });
        });

        RegisterAsyncTask(asyncTask);
    }
}

可行解决方案 #

1. 手动捕获并传递HttpContext到Task.Run内部 #

在Task.Run执行前捕获当前HttpContext，在委托内临时设置HttpContext.Current，并在操作完成后恢复原线程上下文（避免线程池线程被污染）：

var asyncTask = new System.Web.UI.PageAsyncTask(() => {
    // 捕获当前请求的HttpContext
    var requestContext = System.Web.HttpContext.Current;
    return Task.Run(() => {
        // 保存线程池线程原有的上下文
        var originalContext = System.Web.HttpContext.Current;
        try
        {
            // 将当前线程的HttpContext设置为请求上下文
            System.Web.HttpContext.Current = requestContext;
            
            // 此处可正常访问HttpContext，NHibernate能正确获取会话
            var c = System.Web.HttpContext.Current;
            // 执行业务逻辑
            return Task.Delay(5000);
        }
        finally
        {
            // 恢复线程池线程的原上下文，防止后续请求上下文混乱
            System.Web.HttpContext.Current = originalContext;
        }
    });
});

注意：必须在finally块中恢复原上下文，否则线程池中的线程可能携带当前请求的上下文，导致后续请求出现数据污染。

2. 使用AsyncLocal在异步流中自动传递上下文 #

通过AsyncLocal<T>实现上下文在异步流中的自动传递，无需在每个Task.Run处手动捕获：
首先定义静态类持有AsyncLocal实例：

public static class HttpContextAsyncHolder
{
    public static readonly AsyncLocal<HttpContext> Current = new AsyncLocal<HttpContext>();
}

在请求起始点（如Global.asax的Application_BeginRequest）初始化上下文：

protected void Application_BeginRequest(object sender, EventArgs e)
{
    HttpContextAsyncHolder.Current.Value = HttpContext.Current;
}

然后在异步代码中访问并临时设置HttpContext.Current：

var asyncTask = new System.Web.UI.PageAsyncTask(() => {
    return Task.Run(() => {
        var originalContext = System.Web.HttpContext.Current;
        try
        {
            // 从AsyncLocal中获取请求上下文并设置到当前线程
            System.Web.HttpContext.Current = HttpContextAsyncHolder.Current.Value;
            // 执行业务操作，NHibernate可正常获取会话
            return Task.Delay(5000);
        }
        finally
        {
            System.Web.HttpContext.Current = originalContext;
        }
    });
});

这种方式适合需要在多个异步方法中共享上下文的场景，只需一次初始化即可在整个异步流中访问。

3. 移除不必要的Task.Run调用 #

WebForms的PageAsyncTask本身支持异步委托，无需用Task.Run强制切换到线程池线程。直接使用异步方法可以保留ASP.NET的同步上下文，自然持有HttpContext：

var asyncTask = new System.Web.UI.PageAsyncTask(async () => {
    // 此处HttpContext始终存在
    var b = System.Web.HttpContext.Current;
    // 直接执行异步业务操作，无需Task.Run
    await Task.Delay(5000);
    // 操作完成后仍可访问HttpContext
});

这是最安全且推荐的方案，因为PageAsyncTask的异步委托会在ASP.NET的同步上下文中执行，自动维护HttpContext的关联。如果业务操作本身是异步的，直接调用即可；如果是同步操作，也不建议用Task.Run包装，避免上下文丢失。

内容的提问来源于stack exchange，提问作者Remi Despres-Smyth