ASP.NET Core JWT存Cookie时如何实现HttpContext.SignInAsync

首先明确核心逻辑：HttpContext.SignInAsync 和认证方案是强绑定的，默认调用时会使用配置的默认认证方案签发登录凭证。你当前配置的默认方案是JwtBearerDefaults.AuthenticationScheme，但JWT Bearer方案本身没有实现SignInAsync的处理逻辑——它的内置逻辑只有从请求提取、校验JWT，不负责签发凭证，这也是你找不到对应实现参考的核心原因。
要实现JWT存储于Cookie+用SignInAsync完成登录流程，不需要修改现有JWT校验逻辑，只要调整认证方案配置，把Cookie方案作为登录签发的目标，同时保留JWT Bearer从Cookie读取令牌校验的逻辑即可，具体实现步骤如下：

第一步：调整Startup.cs的认证配置 #

不要把JWT Bearer设为默认方案，将Cookie方案设为默认的登录/签退方案，同时明确JWT Bearer作为令牌校验的方案，对齐Cookie配置和你原有JWT存储的规则。
修改后的配置代码：

services.AddTransient<IUserRepository, UserRepository>();
services.AddTransient<ITokenService, TokenService>();
IdentityModelEventSource.ShowPII = true;

services.AddAuthentication(options =>
    {
        // 将Cookie方案设为默认认证、登录、签退方案
        options.DefaultAuthenticateScheme = CookieAuthenticationDefaults.AuthenticationScheme;
        options.DefaultSignInScheme = CookieAuthenticationDefaults.AuthenticationScheme;
        options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
    })
    .AddJwtBearer(options =>
    {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidateAudience = true,
            ValidateLifetime = true,
            ValidateIssuerSigningKey = true,
            ValidIssuer = Configuration["Jwt:Issuer"],
            ValidAudience = Configuration["Jwt:Issuer"],
            IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(Configuration["Jwt:Key"]))
        };
        options.SaveToken = true;
        options.Events = new JwtBearerEvents();
        // 保留原有从Cookie读取JWT的逻辑
        options.Events.OnMessageReceived = context =>
        {
            if (context.Request.Cookies.ContainsKey("X-Access-Token"))
            {
                context.Token = context.Request.Cookies["X-Access-Token"];
            }
            return Task.CompletedTask;
        };
    })
    .AddCookie(options =>
    {
        options.Cookie.Name = "X-Access-Token"; // 和原有存储JWT的Cookie名对齐
        options.Cookie.SameSite = SameSiteMode.Strict;
        options.Cookie.SecurePolicy = CookieSecurePolicy.Always;
        options.Cookie.HttpOnly = true;
        options.Cookie.IsEssential = true;
        // Cookie过期时间和JWT有效期保持一致，即30分钟
        options.ExpireTimeSpan = TimeSpan.FromMinutes(30);
    });

你之前手动写入的X-UsernameCookie属于冗余存储，用户身份信息全部包含在JWT声明中，校验通过后HttpContext.User会自动填充身份信息，无需额外存Cookie。

第二步：修改Login接口，使用SignInAsync完成登录 #

不需要手动调用Response.Cookies.Append写入JWT Cookie，SignInAsync会自动完成Cookie写入操作，只需把生成JWT用到的用户声明构建为ClaimsPrincipal传入，同时关联生成的JWT令牌即可。
修改后的接口代码：

public async Task<IActionResult> Login(LoginModel loginModel, string returnUrl)
{
    if (string.IsNullOrEmpty(loginModel.UserName) || string.IsNullOrEmpty(loginModel.Password))
    {
        ViewBag.Message = "Nem lehet üres";
        return View("Index", loginModel);
    }

    var validUser = GetUser(loginModel);
    if (validUser == null)
    {
        ViewBag.Message = "Nem jó user";
        return View("Index", loginModel);
    }

    var generatedToken = _tokenService.BuildToken(
        _config["Jwt:Key"].ToString(), 
        _config["Jwt:Issuer"].ToString(),
        validUser);

    if (generatedToken == null)
    {
        ViewBag.Message = "Nem jo token";
        return View("Index", loginModel);
    }

    // 构建和JWT内容一致的用户声明
    var claims = new List<Claim>
    {
        new Claim(ClaimTypes.Name, validUser.Name),
        new Claim(ClaimTypes.Role, validUser.Role),
        new Claim(ClaimTypes.NameIdentifier, Guid.NewGuid().ToString())
    };
    var claimsIdentity = new ClaimsIdentity(claims, CookieAuthenticationDefaults.AuthenticationScheme);
    var claimsPrincipal = new ClaimsPrincipal(claimsIdentity);

    // 配置认证属性，对齐JWT过期规则
    var authProperties = new AuthenticationProperties
    {
        IsPersistent = true, // 可根据"记住我"业务需求调整
        ExpiresUtc = DateTimeOffset.UtcNow.AddMinutes(30),
        Items = { ["access_token"] = generatedToken }
    };

    // 调用SignInAsync完成登录，自动写入身份Cookie
    await HttpContext.SignInAsync(
        CookieAuthenticationDefaults.AuthenticationScheme,
        claimsPrincipal,
        authProperties);

    // 若要保持原有Cookie直接存储原始JWT的逻辑，追加以下代码即可，不影响认证流程
    Response.Cookies.Append("X-Access-Token", generatedToken, new CookieOptions()
    {
        HttpOnly = true, 
        SameSite = SameSiteMode.Strict, 
        Secure = true,
        Expires = DateTimeOffset.UtcNow.AddMinutes(30)
    });

    if (!string.IsNullOrEmpty(returnUrl))
    {
        return Redirect(returnUrl);
    }
    return RedirectToAction("MainWindow");
}

关键注意点 #

• 不要混淆两个认证方案的职责：
  • Cookie方案：负责登录（SignIn）、签退（SignOut）、写入/读取身份Cookie
  • JWT Bearer方案：负责从Cookie中提取JWT、校验令牌有效性、填充HttpContext.User的身份信息
• 签退时直接调用await HttpContext.SignOutAsync(CookieAuthenticationDefaults.AuthenticationScheme)即可，会自动清除对应身份Cookie，无需手动删除Cookie。
• 若后续需要在接口中获取当前请求的JWT，直接调用await HttpContext.GetTokenAsync(JwtBearerDefaults.AuthenticationScheme, "access_token")即可，无需手动从Cookie读取。

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