从ASP.NET WebForms迁移到Core后基类HttpContext为空的解决方法

云上老周

2026-7-7

问题解决：ASP.NET Core PageModel中HttpContext为null的异常

错误原因

ASP.NET Core中，PageModel的构造函数执行时，HttpContext尚未完成初始化绑定，此时直接访问HttpContext.Session会触发空引用异常。

修复方案

1. 调整生命周期方法（推荐）

将BindData的调用从构造函数移至页面处理器执行前的生命周期方法OnPageHandlerExecuting，此时HttpContext已可用：

public class BasePage : PageModel
{
    private readonly IConfiguration _configuration;
    private DAL _dal = new DAL();

    public BasePage(IConfiguration configuration)
    {
        _configuration = configuration;
    }

    public override void OnPageHandlerExecuting(PageHandlerExecutingContext context)
    {
        BindData();
        base.OnPageHandlerExecuting(context);
    }

    public void BindData()
    {
        // 统一Session键名，避免逻辑错误
        if (string.IsNullOrEmpty(HttpContext.Session.GetString("Session_DisplayName")))
        {
            HttpContext.Session.SetString("Session_DisplayName", "usera");
        }
    }
}

2. 确保会话服务已启用

ASP.NET Core默认不启用会话，需在Program.cs中添加会话服务配置：

var builder = WebApplication.CreateBuilder(args);

// 添加会话服务
builder.Services.AddSession(options =>
{
    options.IdleTimeout = TimeSpan.FromMinutes(30);
    options.Cookie.HttpOnly = true;
    options.Cookie.IsEssential = true;
});

builder.Services.AddRazorPages();

var app = builder.Build();

// 启用会话中间件（位置必须在UseRouting之后，UseAuthorization之前）
app.UseSession();

app.UseRouting();
app.UseAuthorization();
app.MapRazorPages();

app.Run();