ASP.NET Core 3.1迁移中如何实现Session.IsNewSession会话超时判断
ASP.NET Core 3.1 实现原MVC版
Session.IsNewSession 会话超时判定 ASP.NET Core 没有直接保留老MVC里的Session.IsNewSession属性,这是因为Core的会话存储机制做了重构。老版本的这个属性返回true时,本身就覆盖两类需要触发会话超时处理的场景:用户首次访问无历史有效会话、之前的会话因服务端超时被清理。只要对齐这两类场景的判定,就能1:1复现原有逻辑。
前置基础配置
首先要在Startup.cs中把会话参数和老项目对齐,避免超时周期错位:
public void ConfigureServices(IServiceCollection services) { // ... 其余原有服务注册逻辑 services.AddSession(options => { // 超时时间和原项目保持一致,例如20分钟无操作即判定会话超时 options.IdleTimeout = TimeSpan.FromMinutes(20); options.Cookie.IsEssential = true; }); } // 注意管道配置的顺序:app.UseSession() 必须放在 app.UseMvc() / app.UseRouting() 之前,否则会话无法正常加载
核心判定逻辑
替换原有if (Session.IsNewSession)代码块时,需要覆盖两个判定分支,完全匹配老版本的行为:
- 判定分支1:当前请求没有携带会话Cookie,属于首次访问的全新会话,和老版
IsNewSession的返回结果完全一致 - 判定分支2:当前请求携带了会话Cookie,但服务端会话存储中没有匹配到会话初始化时写入的固定标记值,说明Cookie对应的原始会话已经因超时被服务端清理,同样等价于老版
IsNewSession返回true的场景
对应的控制器内实现代码:
public IActionResult ProtectedPage() { bool isSessionExpired = false; // 判定1:请求未携带会话Cookie,直接标记会话无效 if (!Request.Cookies.ContainsKey(".AspNetCore.Session")) { isSessionExpired = true; } // 判定2:携带了会话Cookie,但会话中没有初始化标记,说明原会话已超时被清理 else if (string.IsNullOrEmpty(HttpContext.Session.GetString("ValidSessionMarker"))) { isSessionExpired = true; } if (isSessionExpired) { // 执行原有的会话超时逻辑:跳转登录页、返回超时提示等 return RedirectToAction("Login", "Account"); } // 原有业务逻辑继续执行 }
关键注意点
- 为什么需要额外写入
ValidSessionMarker标记?因为ASP.NET Core的会话是惰性创建的:当请求带着已经过期的会话Cookie到达时,系统不会主动抛出会话失效的提示,而是会基于这个Cookie直接生成一个新的空会话。如果只靠Cookie是否存在做判定,就会把已超时的会话误判为有效会话,和老MVC的行为产生偏差。只需要在用户登录成功、首次创建有效会话时,往会话里写入这个固定标记即可。 - 为了避免在每个控制器动作里重复写判定逻辑,可以把这部分逻辑封装成自定义ActionFilter,在全局或需要鉴权的控制器上挂载,复用性更高。
内容的提问来源于stack exchange,提问作者Rodrigo Kiguti
相关产品推荐
相关产品推荐

