Blazor现有项目ASP.NET Identity基架搭建报错问题求助

开发者阿泽

2026-9-1

Blazor项目搭建ASP.NET Identity基架报错问题处理

问题核心信息

操作目标：在已内置登录/登出页面的现有Blazor项目中添加完整ASP.NET Identity基架，当前项目已完成数据上下文配置、生成初始迁移
运行环境：项目依赖EF Core 6.0版本，实际安装版本为6.0.5
已尝试操作：按公开的服务端Blazor Identity搭建报错方案处理过Razor页面ComponentBase相关冲突，处理后触发工具类相关异常，基架搭建流程中断
待确认诉求：
- 可行的ASP.NET Identity重置方案
- 当前EF Core版本是否存在Identity基架兼容性问题

EF Core 6.0.5是6.0分支的正式稳定补丁版，不存在已知的Identity基架全局兼容性缺陷，所有搭建报错基本都来自项目残留配置冲突、包版本不统一、代码生成工具版本不匹配三类问题，按以下流程重置后重新搭建即可解决。

这一步是解决冲突的核心，禁止直接在现有残留文件上重复搭建：

直接删除项目中Areas/Identity路径下的所有已生成基架文件
打开Program.cs，移除所有手动添加的Identity相关服务注册与中间件配置，包括AddDefaultIdentity、AddEntityFrameworkStores、UseAuthentication、UseAuthorization等Identity强绑定配置段
打开项目自定义数据上下文类，移除对IdentityDbContext的继承代码，删除上下文中定义的所有Identity相关实体DbSet
删除Migrations文件夹下所有和Identity表相关的迁移文件，同步清理上下文快照文件中残留的Identity表结构定义
手动删除项目根目录下的bin、obj文件夹，执行NuGet包还原，检查所有相关依赖包版本：Microsoft.EntityFrameworkCore、Microsoft.EntityFrameworkCore.Tools、Microsoft.AspNetCore.Identity.EntityFrameworkCore、Microsoft.AspNetCore.Identity.UI四个包的版本必须完全统一为6.0.5，禁止出现不同小版本混装的情况。

工具类异常基本都是本地安装的代码生成工具版本和项目SDK版本不匹配导致：

打开命令行，先执行dotnet tool uninstall -g dotnet-aspnet-codegenerator卸载全局安装的旧版本工具
再执行dotnet tool install -g dotnet-aspnet-codegenerator --version 6.0.5安装和项目依赖版本完全一致的代码生成工具
重启Visual Studio，避免IDE缓存旧版本工具导致的异常。

重新搭建前先编译一次项目，确认无编译错误后再启动基架搭建流程，不要在编译不通过的状态下执行脚手架操作
搭建过程中选择项目自己配置好的业务数据上下文，不要选择脚手架自动生成的临时上下文，勾选「覆盖所有文件」选项
Blazor项目有特殊路由隔离要求：不要修改Identity生成的Razor Pages页面的@inherits指令，这些页面存放在Areas/Identity/Pages路径下，和Blazor组件的ComponentBase基类完全隔离，手动修改继承关系会直接导致路由、渲染冲突。
搭建完成后补充中间件配置，严格按照以下顺序注册，顺序错误会直接导致鉴权失效：
```
app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();
app.MapRazorPages();
app.MapBlazorHub();
```

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