带共享UI库与身份认证的.NET MAUI Blazor开发异常求助

问题根因 #

你遇到的报错本质是Blazor Server专属的ServerAuthenticationStateProvider无法在MAUI Blazor运行环境中正常工作：Blazor Server的认证状态由服务端管道初始化时完成SetAuthenticationState调用，而MAUI Blazor是本地客户端运行模式，不存在服务端预处理流程，直接调用GetAuthenticationStateAsync就会触发该异常。

修复步骤 #

1. 抽离共享层的认证依赖 #

• 所有位于Razor类库的业务代码、UI组件只依赖AuthenticationStateProvider抽象，不要引用任何平台专属的认证实现类。
• 共享层需要获取身份信息时，统一通过依赖注入获取抽象的AuthenticationStateProvider实例调用方法，不要硬编码任何平台特定的认证逻辑。

2. 各端单独实现认证提供器 #

Blazor Server端

保留原有「个人账户」认证的全部配置，无需修改默认的ServerAuthenticationStateProvider注册逻辑、身份存储配置以及认证中间件。

MAUI Blazor端

单独实现适配MAUI平台的AuthenticationStateProvider，对接和Web端相同的身份认证服务即可，示例实现框架如下：

public class MauiAuthenticationStateProvider : AuthenticationStateProvider
{
    public override async Task<AuthenticationState> GetAuthenticationStateAsync()
    {
        // 此处实现本地token校验、身份信息构造逻辑
        var identity = new ClaimsIdentity();
        // 若用户已登录则填充对应的Claims
        return new AuthenticationState(new ClaimsPrincipal(identity));
    }

    // 登录成功后调用该方法通知认证状态变更
    public void NotifyUserLogin(ClaimsPrincipal user)
    {
        NotifyAuthenticationStateChanged(Task.FromResult(new AuthenticationState(user)));
    }

    // 登出后调用该方法清空认证状态
    public void NotifyUserLogout()
    {
        var anonymousUser = new ClaimsPrincipal(new ClaimsIdentity());
        NotifyAuthenticationStateChanged(Task.FromResult(new AuthenticationState(anonymousUser)));
    }
}

在MAUI项目的MauiProgram.cs中注册该实现以及认证相关依赖：

builder.Services.AddAuthorizationCore();
builder.Services.AddScoped<AuthenticationStateProvider, MauiAuthenticationStateProvider>();

3. 调整共享UI入口配置 #

共享Razor类库的根组件只保留通用的认证包裹逻辑即可，不要包含平台专属配置：

<CascadingAuthenticationState>
    <Router AppAssembly="@typeof(App).Assembly">
        <Found Context="routeData">
            <AuthorizeRouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)">
                <NotAuthorized>
                    <!-- 通用的未授权提示逻辑 -->
                </NotAuthorized>
            </AuthorizeRouteView>
        </Found>
        <NotFound>
            <!-- 通用的404逻辑 -->
        </NotFound>
    </Router>
</CascadingAuthenticationState>

4. 复用API调用逻辑 #

所有API调用封装到共享类库中，通过注册DelegatingHandler处理不同端的认证信息传递：Web端自动携带认证Cookie，MAUI端将本地存储的token添加到请求Authorization头，业务层无需感知平台差异。

内容的提问来源于stack exchange，提问作者Duken.Jr