ASP.NET Core 8中Singleton结合HttpContextAccessor取值始终为null问题

为什么Singleton模式下读取会话值为null？ #

核心问题是Singleton生命周期与HttpContext生命周期不匹配：

• Singleton是全局唯一实例，从应用启动到关闭一直存在；而HttpContext是请求级（Scoped）资源，每个请求对应独立的HttpContext，请求结束后会被框架回收。
• 如果你用Singleton的SessionSingleton或CustomHttpContext持有HttpContext引用，会出现两种情况：
  1. 多个请求并发时，后续请求的HttpContext会覆盖Singleton中存储的前一个请求的上下文，导致读取到的是其他请求的上下文（甚至是已回收的无效上下文）。
  2. 当请求完成后，HttpContext被释放，Singleton中保留的引用变成无效对象，此时读取会话值自然返回null。
• 另外，Singleton无法区分不同用户的请求上下文，本质上不适合做会话管理的载体——会话是和单个用户请求绑定的，而Singleton是全局共享的。

简易用户信息存储方案推荐 #

1. 直接使用ASP.NET Core内置ISession #

这是最原生的方案，无需自定义服务：

• 先在Program.cs中配置Session：

  builder.Services.AddDistributedMemoryCache();
  builder.Services.AddSession(options =>
  {
      options.IdleTimeout = TimeSpan.FromMinutes(30);
      options.Cookie.HttpOnly = true;
      options.Cookie.IsEssential = true;
  });
  
  app.UseSession(); // 必须放在UseRouting之后，UseEndpoints之前
  

• 在控制器或服务中注入IHttpContextAccessor，通过Session存取：

  private readonly IHttpContextAccessor _httpContextAccessor;
  
  public HomeController(IHttpContextAccessor httpContextAccessor)
  {
      _httpContextAccessor = httpContextAccessor;
  }
  
  public IActionResult SetUserInfo(UserInfo user)
  {
      var json = JsonSerializer.Serialize(user);
      _httpContextAccessor.HttpContext.Session.SetString("UserInfo", json);
      return Ok();
  }
  
  public IActionResult GetUserInfo()
  {
      var json = _httpContextAccessor.HttpContext.Session.GetString("UserInfo");
      var user = JsonSerializer.Deserialize<UserInfo>(json);
      return Ok(user);
  }
  

2. 自定义Scoped级别的用户会话服务 #

适合需要在多个服务中共享用户信息的场景，每个请求对应独立实例：

• 创建用户会话类：

  public class UserSession
  {
      public UserInfo CurrentUser { get; set; }
  }
  

• 在Program.cs中注册为Scoped服务：

  builder.Services.AddScoped<UserSession>();
  

• 在控制器或服务中直接注入使用：

  private readonly UserSession _userSession;
  
  public HomeController(UserSession userSession)
  {
      _userSession = userSession;
  }
  
  public IActionResult SetUser(UserInfo user)
  {
      _userSession.CurrentUser = user;
      return Ok();
  }
  
  public IActionResult GetUser()
  {
      return Ok(_userSession.CurrentUser);
  }
  

  这个方案的优点是类型安全，无需手动序列化/反序列化，且每个请求的实例独立，不会互相干扰。

3. 利用ClaimsPrincipal存储认证用户信息 #

如果你的应用已经集成了身份认证（比如JWT、Cookie认证），直接将常用用户信息存入Claims：

• 认证时添加Claims：

  var claims = new List<Claim>
  {
      new Claim(ClaimTypes.NameIdentifier, user.Id.ToString()),
      new Claim(ClaimTypes.Name, user.UserName),
      new Claim("Email", user.Email)
  };
  var identity = new ClaimsIdentity(claims, "Cookie");
  var principal = new ClaimsPrincipal(identity);
  await HttpContext.SignInAsync(principal);
  

• 读取时直接从HttpContext.User获取：

  public IActionResult GetCurrentUser()
  {
      var userId = User.FindFirstValue(ClaimTypes.NameIdentifier);
      var userName = User.FindFirstValue(ClaimTypes.Name);
      return Ok(new { userId, userName });
  }
  

  这个方案无需额外存储，信息直接携带在认证票据中，安全且高效。

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