.NET 8 WebApp传Session至.NET Standard类库时Session为空问题

针对你在.NET 8 WebApp迁移时遇到的Session相关问题，以下是具体的解决步骤：

1. 修复“未注册ISessionManager服务”错误 #

这个错误是因为DI容器中缺少Session管理器的注册，你需要在Program.cs中完善System.WebAdapters的Session配置：

// 注册System.WebAdapters及Session适配服务
builder.Services.AddSystemWebAdapters()
    .AddSessionAdapter(options =>
    {
        // 按需配置Session超时等参数
        options.Timeout = TimeSpan.FromMinutes(20);
    });

// 配置中间件，注意顺序不能错
app.UseSystemWebAdapters();
app.UseSession();
// 全局强制Session验证（可选，若不需要全局可只在控制器用[Session]特性）
app.RequireSystemWebAdapterSession();

// 之后再配置路由和控制器
app.MapControllers();

2. 控制器中正确使用Session特性 #

在控制器中使用[Session]特性时，确保引用正确的命名空间，并且控制器继承自标准的Controller基类：

using Microsoft.AspNetCore.SystemWebAdapters;

public class IncidentController : Controller
{
    [Session]
    public IActionResult ProcessIncident()
    {
        // 两种方式访问Session：ASP.NET Core原生方式或兼容System.Web的方式
        var incidentId = HttpContext.Session.GetString("IncidentID");
        var legacyIncidentId = System.Web.HttpContext.Current.Session["IncidentID"]?.ToString();
        
        // 业务逻辑处理
        return Ok();
    }
}

3. 让.NET Standard 2.0类库访问Session #

由于.NET Standard 2.0类库无法直接依赖ASP.NET Core的上下文，推荐用依赖注入的方式解耦：

步骤1：类库中定义Session访问接口 #

// 类库项目中添加接口
public interface ISessionDataAccessor
{
    string GetIncidentId();
}

步骤2：ASP.NET Core项目中实现接口 #

using Microsoft.AspNetCore.Http;
using System.Web;

public class SessionDataAccessor : ISessionDataAccessor
{
    private readonly IHttpContextAccessor _httpContextAccessor;

    public SessionDataAccessor(IHttpContextAccessor httpContextAccessor)
    {
        _httpContextAccessor = httpContextAccessor;
    }

    public string GetIncidentId()
    {
        // 通过System.Web兼容层获取Session中的值
        return HttpContext.Current.Session["IncidentID"]?.ToString();
    }
}

步骤3：注册服务并注入到类库 #

在Program.cs中注册依赖：

builder.Services.AddHttpContextAccessor();
builder.Services.AddScoped<ISessionDataAccessor, SessionDataAccessor>();

之后在类库的服务中，通过构造函数注入ISessionDataAccessor即可获取IncidentID：

// 类库中的业务服务
public class IncidentService
{
    private readonly ISessionDataAccessor _sessionAccessor;

    public IncidentService(ISessionDataAccessor sessionAccessor)
    {
        _sessionAccessor = sessionAccessor;
    }

    public void Process()
    {
        var incidentId = _sessionAccessor.GetIncidentId();
        // 后续业务逻辑
    }
}

4. 常见排查点 #

• 中间件顺序错误是最常见的问题：必须保证UseSystemWebAdapters -> UseSession -> RequireSystemWebAdapterSession的顺序，且在路由中间件之前。
• 确保类库已安装Microsoft.AspNetCore.SystemWebAdapters.Abstractions NuGet包，否则无法引用System.Web.HttpContext兼容层。
• 如果移除配置后System.Web.HttpContext.Current.Session为空，说明Session适配层未正确初始化，必须保留AddSessionAdapter和对应的中间件配置。

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