Blazor Server .NET 9预览版中调用IServiceCollection的AddAuthenticationStateSerialization方法出现CS1061错误

嘿，最近碰到个挺闹心的Blazor Server问题，正好和你可能遇到的情况对上——在.NET 9预览版项目里调用AddAuthenticationStateSerialization方法时，直接弹出CS1061错误，说IServiceCollection压根没有这个方法的定义，也找不到适配的扩展方法。

先给你还原下场景：我帮朋友排查的这个项目，是基于.NET 9预览版的Blazor Server应用，用的是标准Cookie认证，核心需求很明确：用户登录后强制刷新页面，初始渲染阶段得立刻能获取到用户的身份信息，毕竟预渲染时的认证状态处理一直是Blazor的小痛点。他本来想跟着.NET 8及以上版本的推荐方案，用AddAuthenticationStateSerialization来搞定，结果一写代码就踩坑。

我给他梳理了几个大概率的排查方向，你也可以照着试试：

• 先盯紧命名空间和NuGet包：这个扩展方法在.NET 8里属于Microsoft.AspNetCore.Components.Authentication命名空间，还得安装对应的NuGet包。但.NET 9是预览版，API归属或者包版本说不定有调整，你得确认项目里是不是装了最新的.NET 9预览版Microsoft.AspNetCore.Components.Authentication包，而且代码顶部有没有加using Microsoft.AspNetCore.Components.Authentication;。
• 警惕预览版API变动：毕竟是未正式发布的预览版本，API迭代很正常，说不定AddAuthenticationStateSerialization被重命名了，或者移到别的扩展类里了。你可以翻下.NET 9预览版的官方文档，搜下认证状态序列化相关的内容，看看API有没有调整。
• 服务注册顺序别搞反：有没有可能你在注册认证服务之前就调用了这个序列化方法？正确的顺序应该是先配置Cookie认证，再调用序列化方法，比如：

// 先配置Cookie认证
builder.Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
    .AddCookie(options =>
    {
        options.LoginPath = "/Login";
        options.ExpireTimeSpan = TimeSpan.FromHours(8);
        // 其他自定义Cookie配置
    });

// 再调用认证状态序列化方法
builder.Services.AddAuthenticationStateSerialization();

• 确认目标框架真的是.NET 9：别小看这个细节，有时候项目文件里的TargetFramework可能还是net8.0，你得打开.csproj文件看看是不是写的<TargetFramework>net9.0</TargetFramework>，而且SDK版本也是对应的预览版。

如果上面的方法都试了还不行，那可以先整个临时方案过渡：在预渲染组件里，通过注入IHttpContextAccessor手动读取Cookie里的身份信息，虽然不如官方扩展方法优雅，但能先满足需求。比如在组件里这么写：

@inject IHttpContextAccessor HttpContextAccessor
@code {
    private ClaimsPrincipal? CurrentUser { get; set; }

    protected override void OnInitialized()
    {
        CurrentUser = HttpContextAccessor.HttpContext?.User;
    }
}

要是还没解决，也可以去.NET的GitHub仓库看看有没有相关Issue，说不定其他开发者也碰到了，已经有临时的解决办法。

备注：内容来源于stack exchange，提问作者Javy Colón