Blazor应用部署IIS后状态丢失 IISExpress环境运行正常

架构老林

2026-8-26

问题根因

核心逻辑错误：Blazor Server存在两次独立的执行上下文：第一次是页面初始请求的HTTP预渲染上下文，第二次是SignalR电路建立后的交互式上下文。你在OnInitialized生命周期通过IHttpContextAccessor获取用户信息、给Scoped服务LoginState赋值的逻辑，只在第一次预渲染的HTTP上下文里生效；等1秒左右SignalR连接建立后，会启动全新的电路上下文，Scoped服务是独立的新实例，预渲染阶段存的登录状态完全丢失，组件重新渲染就会显示未授权。
环境配置问题：IIS默认未安装WebSocket协议，导致你看到Failed to connect via WebSockets警告，Blazor会回退到长轮询传输，进一步放大了两次上下文切换的感知差异；IIS Express默认开启WebSocket，本地调试时传输层更顺畅，且调试模式下预渲染的时序差异不容易被触发，所以看起来运行正常。
代码写法问题：你错误地将AuthenticationStateProvider的注入名写成了GetAuthenticationStateAsync，完全没有使用Blazor官方提供的、跨上下文可靠的认证状态获取通道，反而依赖仅在初始HTTP请求阶段有效的HttpContext。

修复方案

首先修复IIS配置：打开服务器管理器，添加角色和功能，依次进入「Web服务器(IIS)」-「应用程序开发」，勾选「WebSocket协议」完成安装，重启IIS站点消除WebSocket连接警告。
修正认证状态获取逻辑：不要在OnInitialized阶段访问IHttpContextAccessor拿用户信息，改为在OnAfterRenderAsync的第一次渲染逻辑中，通过AuthenticationStateProvider获取可靠的认证状态，修正后的布局组件代码如下：

@inherits LayoutComponentBase
@inject AuthenticationStateProvider AuthStateProvider
@inject Data.LoginState loginState

<PageTitle>Tools</PageTitle>

<div class="page">
    <div class="sidebar">
        <NavMenu />
    </div>

    <main>
        <div class="top-row px-4">
            @if (!loginState.IsLoggedIn)
            {
                <h5>You are not authorized</h5>
            }
            else
            {
                <h5>Welcome: @loginState.username</h5>
            }
        </div>

        <article class="content px-4">
            @Body
        </article>
    </main>
</div>

@code{
    protected override async Task OnAfterRenderAsync(bool firstRender)
    {
        if (firstRender)
        {
            var authState = await AuthStateProvider.GetAuthenticationStateAsync();
            var user = authState.User;
            if (user.Identity?.IsAuthenticated == true)
            {
                var username = user.Identity.Name.Substring(user.Identity.Name.IndexOf(@"\") + 1);
                await loginState.SetLoginAsync(true, username);
                StateHasChanged();
            }
        }
    }
}

可选优化（彻底消除渲染闪烁）：如果不需要预渲染带来的首屏加载速度提升，可以直接关闭预渲染。找到Pages/_Host.cshtml文件中的组件渲染标签，将render-mode从ServerPrerendered改为Server：

<component type="typeof(App)" render-mode="Server" />

修改后页面会等SignalR电路完全建立、认证状态确认后再首次渲染，不会出现先显示用户名再跳未授权的闪烁问题。

注意：Blazor Server场景下，IHttpContextAccessor仅能在初始HTTP请求的预渲染阶段、以及静态中间件流程中可靠使用，所有交互式组件的逻辑都不要依赖它获取用户、请求相关的状态，应该统一使用AuthenticationStateProvider等Blazor原生提供的状态服务。

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