ASP.NET Core视图中HttpContextAccessor.Session.SetString不生效问题

核心原因 #

你遇到的Session修改后值无法保留的问题，最关键的原因是未在Program.cs中启用Session中间件，仅通过AddSession注册Session服务不足以让Session的读写操作生效并持久化。另外，中间件的注册顺序错误也会导致Session功能失效。

具体修复步骤 #

1. 修正Program.cs的中间件配置 #

在Program.cs的HTTP请求管道配置中，必须在app.UseRouting()之后、app.UseAuthorization()和路由映射之前添加app.UseSession()，确保Session中间件的执行顺序正确：

var builder = WebApplication.CreateBuilder(args);

// 注册Session服务
builder.Services.AddSession(options =>
{
    options.IdleTimeout = TimeSpan.FromMinutes(10);
});
builder.Services.AddHttpContextAccessor();
builder.Services.AddControllersWithViews();

var app = builder.Build();

// 环境相关配置
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();
// 启用Session中间件，位置必须在UseRouting之后、UseAuthorization之前
app.UseSession();

app.UseAuthorization();

// 路由映射
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

2. 优化视图中Session的操作方式 #

视图中无需依赖HttpContextAccessor，直接通过ViewContext.HttpContext.Session操作Session即可，代码更简洁直接：

@{
    ViewContext.HttpContext.Session.SetString("PrimaryNavigation", "Second");
}

3. 验证Session持久化逻辑 #

当在视图中修改Session后，ASP.NET Core会在当前请求结束时自动将Session变更写入默认内存存储，后续的Ajax请求就能读取到更新后的值。

额外注意事项 #

• Session中间件的注册顺序是核心：必须在路由匹配之后、授权校验之前启用，否则Session无法正常读写。
• 若后续切换为分布式Session存储（如Redis），需额外配置对应存储服务，但当前默认内存存储场景下，仅需保证中间件配置正确即可。

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