如何用Register.razor覆盖Identity Core的Register.cshtml页面？

算力阿峰

2026-7-25

解决Blazor Server自定义Register页面优先于Identity MVC页面的问题

核心原因

ASP.NET Core默认路由优先级中，MVC Razor页面的匹配优先级高于Blazor组件路由，所以即使你定义了同URL的Blazor页面，仍会优先加载Identity DLL里的MVC页面。

具体解决方法

方法1：调整路由注册顺序

在Program.cs里把Blazor相关的路由注册代码放在Identity路由之前，让Blazor组件先匹配请求：

// 先注册Blazor路由
app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

// 再注册Identity的Razor Pages路由
app.MapRazorPages();

默认项目里MapRazorPages()通常在Blazor路由之前，调整顺序后Blazor组件的路由会先被匹配。

方法2：移除Identity MVC页面的路由规则

通过自定义路由约定，清除Identity DLL中Register页面的路由模板，让Blazor页面的路由生效：

builder.Services.AddRazorPages(options =>
{
    options.Conventions.Add(new RemoveIdentityRegisterRouteConvention());
});

// 自定义路由约定类
public class RemoveIdentityRegisterRouteConvention : IPageRouteModelConvention
{
    public void Apply(PageRouteModel model)
    {
        // 定位到Identity里的Register页面
        if (model.RelativePath.Equals("/Identity/Account/Register.cshtml", StringComparison.OrdinalIgnoreCase))
        {
            // 移除该页面的所有路由匹配规则
            model.Selectors.Clear();
        }
    }
}

方法3：用MapWhen拦截特定路由

直接针对/Identity/Account/Register路径，让它走Blazor的路由管道：

app.MapRazorPages();

// 拦截Register路径，优先使用Blazor路由
app.MapWhen(context => 
    context.Request.Path.StartsWithSegments("/Identity/Account/Register"), 
    appBuilder =>
{
    appBuilder.UseRouting();
    appBuilder.UseEndpoints(endpoints =>
    {
        endpoints.MapBlazorHub();
        endpoints.MapFallbackToPage("/_Host");
    });
});