.NET8 Blazor Server启动时自动登录默认IdentityUser的方法

核心思路 #

放弃全局静态的认证Handler，采用基于Cookie认证的动态登录逻辑——在应用启动的初始页面加载阶段自动完成默认用户的Cookie认证，同时保留正常的登录/登出流程，让用户可以随时切换账号。

步骤1：准备默认用户与基础Identity配置 #

确保你的Blazor Server项目已配置好ASP.NET Core Identity，且数据库中存在预设的默认用户（比如账号为admin@example.com的用户）。如果还未配置，可通过AddDefaultIdentity或AddIdentity完成基础配置，并在Program.cs中添加对应的数据库上下文。

步骤2：实现自动登录服务 #

创建自定义服务封装自动登录和用户切换逻辑，避免业务代码耦合：

public interface IAutoLoginService
{
    Task AutoLoginAsync(HttpContext context);
    Task LoginUserAsync(HttpContext context, string email);
}

public class AutoLoginService : IAutoLoginService
{
    private readonly UserManager<ApplicationUser> _userManager;
    private readonly SignInManager<ApplicationUser> _signInManager;
    private readonly IWebHostEnvironment _env;

    public AutoLoginService(UserManager<ApplicationUser> userManager, 
                           SignInManager<ApplicationUser> signInManager,
                           IWebHostEnvironment env)
    {
        _userManager = userManager;
        _signInManager = signInManager;
        _env = env;
    }

    public async Task AutoLoginAsync(HttpContext context)
    {
        // 仅在开发环境自动登录，规避生产环境安全风险
        if (!_env.IsDevelopment()) return;
        
        // 已认证则跳过自动登录流程
        if (context.User.Identity?.IsAuthenticated == true) return;

        // 从数据库获取预设默认用户（替换为你的默认用户账号）
        var defaultUser = await _userManager.FindByEmailAsync("admin@example.com");
        if (defaultUser == null) return;

        // 执行Cookie登录，持久化用户身份信息
        await _signInManager.SignInAsync(defaultUser, isPersistent: false);
    }

    public async Task LoginUserAsync(HttpContext context, string email)
    {
        // 先登出当前用户，确保身份完全切换
        await _signInManager.SignOutAsync();
        
        // 登录目标用户
        var targetUser = await _userManager.FindByEmailAsync(email);
        if (targetUser != null)
        {
            await _signInManager.SignInAsync(targetUser, isPersistent: false);
            // 刷新页面，确保Blazor组件获取最新身份信息
            context.Response.Redirect("/");
        }
    }
}

步骤3：注册服务与配置认证 #

在Program.cs中注册自定义服务，并确保Cookie认证配置正常（Identity默认已包含Cookie认证，重点保留正常登录流程）：

var builder = WebApplication.CreateBuilder(args);

// 添加Identity服务（根据项目需求调整，比如是否启用角色）
builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
builder.Services.AddDefaultIdentity<ApplicationUser>(options => options.SignIn.RequireConfirmedAccount = false)
    .AddEntityFrameworkStores<ApplicationDbContext>();

// 注册自动登录服务
builder.Services.AddScoped<IAutoLoginService, AutoLoginService>();
// 注册HttpContextAccessor，用于Blazor组件中获取上下文
builder.Services.AddHttpContextAccessor();

builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();
// ...其他服务注册

var app = builder.Build();

// ...中间件配置（静态文件、路由等）

app.UseAuthentication();
app.UseAuthorization();

app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

app.Run();

步骤4：在初始页面触发自动登录 #

修改_Host.cshtml，在页面渲染前调用自动登录服务——这是Blazor Server的初始请求入口，能确保用户进入应用前完成认证：

@page "/"
@namespace YourProjectName.Pages
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
@inject IAutoLoginService AutoLoginService
@{
    Layout = null;
}

@{
    // 页面加载时执行自动登录逻辑
    await AutoLoginService.AutoLoginAsync(HttpContext);
}

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Your Blazor App</title>
    <base href="~/" />
    <link rel="stylesheet" href="css/bootstrap/bootstrap.min.css" />
    <link rel="stylesheet" href="css/site.css" />
    <link rel="stylesheet" href="YourProjectName.styles.css" />
</head>
<body>
    <component type="typeof(App)" render-mode="ServerPrerendered" />

    <div id="blazor-error-ui">
        <environment include="Staging,Production">
            发生错误，应用可能需要重新加载才能恢复响应。
        </environment>
        <environment include="Development">
            发生未处理异常，请查看浏览器开发者工具获取详情。
        </environment>
        <a href="" class="reload">重新加载</a>
        <a class="dismiss">🗙</a>
    </div>

    <script src="_framework/blazor.server.js"></script>
</body>
</html>

步骤5：实现用户切换功能 #

在Blazor组件中注入相关服务，添加切换用户的UI与逻辑：

@inject IAutoLoginService AutoLoginService
@inject SignInManager<ApplicationUser> SignInManager
@inject NavigationManager NavManager
@inject IHttpContextAccessor HttpContextAccessor

<div>
    当前登录用户: @context.User.Identity?.Name
</div>

@if (context.User.Identity?.IsAuthenticated == true)
{
    <button @onclick="SignOut">登出</button>
    <div style="margin-top:10px;">
        <input @bind="targetEmail" placeholder="输入目标用户邮箱" />
        <button @onclick="SwitchUser">切换用户</button>
    </div>
}

@code {
    private string targetEmail = "";

    private async Task SignOut()
    {
        await SignInManager.SignOutAsync();
        NavManager.NavigateTo("/", forceLoad: true);
    }

    private async Task SwitchUser()
    {
        var httpContext = HttpContextAccessor.HttpContext;
        if (httpContext != null && !string.IsNullOrEmpty(targetEmail))
        {
            await AutoLoginService.LoginUserAsync(httpContext, targetEmail);
        }
    }
}

关键说明 #

• 自动登录仅在开发环境触发，避免生产环境自动登录带来的安全隐患
• 采用Cookie认证而非全局静态Handler，每个用户会话的身份独立，支持随时切换
• 切换用户时先登出当前用户，再登录目标用户，确保身份信息完全替换

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