ASP.NET Core 6 MVC本地调试Session值丢失问题求助

开发ASP.NET Core 6 MVC应用时碰到以下Session相关问题：

• 首次调用设置Session值的方法时，Session为空，多次调用后值才会保留
• 跨控制器读取Session出现异常
• 部署到服务器后功能正常，怀疑是Visual Studio 2023本地调试环境导致

相关代码 #

控制器构造代码 #

private readonly IHttpContextAccessor _contextAccessor;
private readonly ISessionHelpers _sessionHelpers;

public CobraController(IHttpContextAccessor contextAccessor, ISessionHelpers sessionHelpers)
{
    _contextAccessor = contextAccessor;
    _sessionHelpers = sessionHelpers;
}

核心方法代码 #

[HttpPost("LandingPage")]
[ValidateAntiForgeryToken]
[ClientWebError(IsPartial = true)]
public async Task<IActionResult> LandingPage()
{
    return PartialView("Landing", await GetEmployeeCounts());
}

private async Task<string> GetEmployeeCounts()
{
    if (_contextAccessor.HttpContext?.Session == null)
        throw new Exception(ConstantValues.SESSIONNULLERROR);
   
    var session = _contextAccessor.HttpContext.Session;
    string employeeCount = _sessionHelpers.GetString(session, ConstantValues.SESSIONEMPLOYEECOUNT);
    _sessionHelpers.SetString(session, ConstantValues.SESSIONEMPLOYEECOUNT, "VALUE");
    return employeeCount;
}

Program.cs Session配置 #

builder.Services.AddSession(options =>
{
    options.IdleTimeout = TimeSpan.FromMinutes(10);
});

原因分析与解决方案 #

1. 中间件注册顺序错误 #

ASP.NET Core中间件执行顺序是硬规则，UseSession必须在UseRouting之后、UseAuthorization和UseEndpoints之前注册，而且光调用AddSession不够，必须调用app.UseSession()才能启用Session中间件。本地调试时如果顺序不对或漏加UseSession，就会出现Session读写异常，而服务器上可能配置正确所以正常。

修复代码（Program.cs）：

var app = builder.Build();

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

app.UseRouting();
app.UseSession(); // 必须放在这个位置
app.UseAuthorization();

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

app.Run();

2. IHttpContextAccessor未显式注册 #

虽然代码里注入了IHttpContextAccessor，但如果Program.cs里没显式注册这个服务，本地调试时可能出现上下文获取不稳定的情况，导致Session读取异常。

修复代码（Program.cs）：

builder.Services.AddHttpContextAccessor();

3. 首次调用的逻辑问题 #

你当前的GetEmployeeCounts是先读Session再写入值，所以首次调用返回的必然是空值——这是逻辑问题，和调试环境无关。如果要首次调用就返回设置的值，调整代码顺序即可：

private async Task<string> GetEmployeeCounts()
{
    if (_contextAccessor.HttpContext?.Session == null)
        throw new Exception(ConstantValues.SESSIONNULLERROR);
   
    var session = _contextAccessor.HttpContext.Session;
    // 先写入再读取
    _sessionHelpers.SetString(session, ConstantValues.SESSIONEMPLOYEECOUNT, "VALUE");
    string employeeCount = _sessionHelpers.GetString(session, ConstantValues.SESSIONEMPLOYEECOUNT);
    return employeeCount;
}

4. 本地调试的浏览器会话问题 #

Visual Studio本地调试时，浏览器的隐私模式、Cookie禁用或缓存可能导致Session Cookie无法正确保留。可以试试：

• 用普通浏览器窗口调试，别用隐私模式
• 清除浏览器的缓存和Cookie后重新启动调试
• 检查浏览器是否允许该站点的Cookie

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