ASP.NET Core(.NET7) Razor Pages会话刷新即失效问题求助

1. 确保中间件顺序正确 #

Session 中间件的注册顺序直接决定功能是否正常，必须严格遵循以下顺序：

• 在 UseRouting 之后注册
• 在 UseAuthorization 和页面路由中间件之前注册
• 在任何需要访问 Session 的业务中间件之前注册

完整的Program.cs配置示例：

var builder = WebApplication.CreateBuilder(args);

// 添加分布式内存缓存（必须在AddSession之前）
builder.Services.AddDistributedMemoryCache();

// 配置Session
builder.Services.AddSession(options =>
{
    options.Cookie.Name = ".SuperMemory.Session";
    options.IdleTimeout = TimeSpan.FromMinutes(20);
    options.Cookie.IsEssential = true;
    // 可选：配置SameSite避免跨域/子域场景下Cookie丢失
    options.Cookie.SameSite = SameSiteMode.Lax;
    // HTTPS环境下可启用Secure策略
    // options.Cookie.SecurePolicy = CookieSecurePolicy.Always;
});

// 添加Razor Pages服务
builder.Services.AddRazorPages();

var app = builder.Build();

// 异常处理中间件
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

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

// 路由中间件，必须在UseSession之前
app.UseRouting();

// 启用Session中间件，位置务必正确！
app.UseSession();

app.UseAuthorization();

// Razor Pages路由映射
app.MapRazorPages();

app.Run();

2. 检查Session读写逻辑是否正确 #

登录成功时，确保正确写入Session：

// Login.cshtml.cs的登录提交方法
public async Task<IActionResult> OnPostAsync()
{
    // 用户验证逻辑...
    
    // 设置Session值
    HttpContext.Session.SetString("_isLogged", "true");
    HttpContext.Session.SetString("_Name", Username);
    
    return RedirectToPage("/Index");
}

读取Session时，保证键名与写入时完全一致：

// Index.cshtml.cs的页面加载方法
public void OnGet()
{
    var isLogged = HttpContext.Session.GetString("_isLogged");
    var userName = HttpContext.Session.GetString("_Name");
    
    // 使用Session数据渲染页面...
}

3. 规范登出逻辑 #

登出时主动清除Session，避免残留数据：

// Logout.cshtml.cs的登出方法
public async Task<IActionResult> OnGetAsync()
{
    // 清除指定Session键
    HttpContext.Session.Remove("_isLogged");
    HttpContext.Session.Remove("_Name");
    // 或直接清空整个Session
    // HttpContext.Session.Clear();
    
    return RedirectToPage("/Login");
}

4. 排查Cookie相关问题 #

• 开发环境非HTTPS时，不要设置CookieSecurePolicy.Always，否则Cookie不会被浏览器保存
• 跨域/子域部署场景，将SameSite设为SameSiteMode.None（需配合HTTPS），并配置Cookie.Domain为父域
• 检查浏览器是否禁用Cookie，Session依赖Cookie存储Session ID，禁用Cookie会直接导致Session失效

5. 验证Session运行状态 #

在页面中添加调试代码，确认Session ID和存储值是否稳定：

<!-- 在Index.cshtml中添加调试内容 -->
<p>Session ID: @Context.Session.Id</p>
<p>登录状态: @Context.Session.GetString("_isLogged")</p>
<p>用户名: @Context.Session.GetString("_Name")</p>

刷新页面时，如果Session ID保持不变，说明Session机制正常；若ID频繁变化，说明Session ID的Cookie未被正确保存，需重新检查Cookie配置。

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