Blazor Server Side应用如何在加载时实现根路径到/route1的自动重定向

完全可以通过ASP.NET Core内置的请求管道中间件实现跨平台通用的重定向逻辑，不依赖任何特定宿主（IIS、Windows自托管、Linux部署环境）的配置规则，代码写一次全环境生效。

实现原理 #

把重定向判断逻辑挂在请求处理管道的最前端，优先级高于Blazor端点路由、静态文件服务等所有后续中间件：

• 请求到达Kestrel服务器后，第一时间判断请求路径是否为根路径/
• 匹配规则时直接返回3xx重定向响应，中断后续管道流程
• 不匹配时正常放行，走原有Blazor应用的处理逻辑

具体实现方式 #

打开Blazor Server项目的Program.cs，在所有应用中间件注册的最前面插入重定向判断逻辑，参考代码如下：

var builder = WebApplication.CreateBuilder(args);

// 原有服务注册逻辑完全保留：比如AddRazorComponents、AddServerSideBlazor、AddAuthentication等
var app = builder.Build();

// 以下为重定向逻辑，必须放在所有中间件注册的最前面
app.Use(async (context, next) =>
{
    // 匹配用户访问根域名的场景：请求路径为"/"，无后续路由段
    if (context.Request.Path.Equals("/", StringComparison.OrdinalIgnoreCase))
    {
        // 重定向到目标路由 /route1，可根据需要设置为永久重定向（permanent: true）
        context.Response.Redirect("/route1", permanent: false);
        // 直接返回响应，不再执行后续管道逻辑
        return;
    }
    // 非根路径请求正常走后续处理流程
    await next();
});

// 原有管道逻辑完全保留：比如UseStaticFiles、UseRouting、MapBlazorHub、MapFallbackToPage("/_Host")等
app.Run();

方案优势 #

• 跨平台兼容性拉满：不管最终部署为IIS站点、Windows服务自托管、还是Linux下用systemd/Nginx反向代理托管，逻辑都由ASP.NET Core运行时处理，不需要针对不同环境单独配置规则
• 逻辑可控：可以直接在判断条件里灵活加规则，比如排除特定域名、对未登录用户做差异化重定向、屏蔽某些来源的请求，不需要依赖外部配置文件
• 维护成本低：所有逻辑集中在应用代码里，和应用一起编译部署，不存在部署时漏配IIS规则、Nginx重写规则的问题

注意事项 #

• 重定向逻辑的位置一定要放在所有其他中间件的最前面，如果放在Blazor路由、静态文件中间件后面，可能出现已经加载完页面才重定向的问题，增加不必要的带宽消耗
• 如果部署环境前面套了Nginx、Apache等反向代理，不需要在反向代理侧额外加重写规则，因为应用返回的3xx重定向响应会被反向代理正常透传给客户端

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