.NET 8自定义ISession扩展方法会话超时失效问题求助

你的扩展方法不生效的核心原因是对ISession的工作机制理解有误：

1. ISession是请求范围实例：每个HTTP请求都会创建独立的ISession实例，后台任务中持有的是请求结束后的旧实例，调用Remove/Clear只会修改该实例的本地缓存，无法同步到服务器端的会话存储（比如内存缓存、Redis）。
2. 后台任务脱离请求生命周期：ASP.NET Core的会话变更会在请求结束时自动持久化到存储，但后台任务的操作不在请求流程内，修改不会被写入实际存储。

以下是针对.NET 8的可行解决方案：

方案一：针对单个会话键设置独立超时（推荐） #

利用ASP.NET Core的缓存系统（IDistributedCache/IMemoryCache）存储带过期时间的会话数据，用会话ID做前缀区分不同用户的缓存项：

扩展方法实现 #

public static class SessionCacheExtensions
{
    // 设置带过期时间的会话数据
    public static void SetStringWithExpiry(this IHttpContextAccessor httpContextAccessor, 
                                          string key, 
                                          string value, 
                                          TimeSpan expireAfter)
    {
        var sessionId = httpContextAccessor.HttpContext.Session.Id;
        var cacheKey = $"Session_{sessionId}_{key}";
        
        var cache = httpContextAccessor.HttpContext.RequestServices.GetRequiredService<IDistributedCache>();
        cache.SetString(cacheKey, value, new DistributedCacheEntryOptions
        {
            AbsoluteExpirationRelativeToNow = expireAfter
        });
    }

    // 获取会话数据
    public static string? GetStringWithExpiry(this IHttpContextAccessor httpContextAccessor, string key)
    {
        var sessionId = httpContextAccessor.HttpContext.Session.Id;
        var cacheKey = $"Session_{sessionId}_{key}";
        
        var cache = httpContextAccessor.HttpContext.RequestServices.GetRequiredService<IDistributedCache>();
        return cache.GetString(cacheKey);
    }

    // 删除会话数据
    public static void RemoveStringWithExpiry(this IHttpContextAccessor httpContextAccessor, string key)
    {
        var sessionId = httpContextAccessor.HttpContext.Session.Id;
        var cacheKey = $"Session_{sessionId}_{key}";
        
        var cache = httpContextAccessor.HttpContext.RequestServices.GetRequiredService<IDistributedCache>();
        cache.Remove(cacheKey);
    }
}

使用步骤 #

1. 在Program.cs注册依赖：

builder.Services.AddHttpContextAccessor();
builder.Services.AddDistributedMemoryCache(); // 开发环境用内存缓存，生产建议替换为Redis
builder.Services.AddSession();

2. 在控制器/服务中注入IHttpContextAccessor后使用：

// 设置带5分钟过期的会话数据
_httpContextAccessor.SetStringWithExpiry("SampleKey", "SampleValue", TimeSpan.FromMinutes(5));

// 获取数据
var value = _httpContextAccessor.GetStringWithExpiry("SampleKey");

方案二：针对整个会话设置全局超时 #

如果需求是给不同用户的整个会话设置不同超时，可通过中间件+缓存实现：

1. 登录时记录会话超时时间 #

public async Task<IActionResult> Login(string username, string password)
{
    // 用户名密码验证逻辑...
    TimeSpan sessionTimeout = username == "admin" ? TimeSpan.FromHours(2) : TimeSpan.FromMinutes(15);
    
    var cache = HttpContext.RequestServices.GetRequiredService<IDistributedCache>();
    var cacheKey = $"SessionTimeout_{HttpContext.Session.Id}";
    await cache.SetStringAsync(cacheKey, sessionTimeout.TotalSeconds.ToString(), 
        new DistributedCacheEntryOptions { AbsoluteExpirationRelativeToNow = sessionTimeout });
    
    // 其他登录逻辑...
    return RedirectToAction("Index");
}

2. 编写超时检查中间件 #

public class SessionTimeoutMiddleware
{
    private readonly RequestDelegate _next;

    public SessionTimeoutMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        if (context.Session.IsAvailable && !string.IsNullOrEmpty(context.Session.Id))
        {
            var cache = context.RequestServices.GetRequiredService<IDistributedCache>();
            var cacheKey = $"SessionTimeout_{context.Session.Id}";
            var timeoutStr = await cache.GetStringAsync(cacheKey);
            
            // 缓存项过期，说明会话超时，清空会话
            if (timeoutStr == null)
            {
                context.Session.Clear();
            }
        }

        await _next(context);
    }
}

3. 注册中间件 #

在Program.cs中添加：

app.UseSession();
app.UseMiddleware<SessionTimeoutMiddleware>();

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