ASP.NET Core Blazor 中处理未找到页面的最佳实践

在 ASP.NET Core Blazor 开发中，处理未找到路径（404）是一个常见的需求。随着 .NET 8 的发布，Blazor 在这方面的行为发生了变化，开发者需要了解这些变化并掌握正确的处理方式。

传统处理方式与变化

在 .NET 7 及更早版本中，Blazor 应用通常使用 <NotFound> 组件来处理未匹配的路由。这种方式简单直接，但存在一些潜在问题，特别是在与服务器端渲染（SSR）和静态渲染结合使用时。

.NET 8 改变了这一行为，转而推荐使用标准的 ASP.NET Core 中间件来处理未找到的页面。这一变化虽然带来了更好的灵活性和一致性，但也给习惯了旧方式的开发者带来了困惑。

推荐的解决方案

目前推荐的解决方案是结合使用 UseStatusCodePagesWithReExecute 中间件和自定义处理逻辑。这种方法既能保持 URL 不变，又能提供友好的用户界面。

app.UseStatusCodePagesWithReExecute("/");

// 排除API路径的处理
app.Use(async (context, next) =>
{
    if (context.Request.Path.StartsWithSegments("/api", StringComparison.OrdinalIgnoreCase))
    {
        var statusCodeFeature = context.Features.Get<IStatusCodePagesFeature>();
        if (statusCodeFeature != null && statusCodeFeature.Enabled)
        {
            statusCodeFeature.Enabled = false;
        }
    }
    await next();
});

这段代码实现了以下功能：

1. 对所有未找到的路径重新执行根路径("/")的处理
2. 特别排除了以"/api"开头的路径，不对其应用自定义404页面
3. 保持了原始URL在浏览器地址栏中不变

未来发展方向

微软团队已经确认在 .NET 10.0 中会进一步改进这一功能。虽然不会恢复旧的 <NotFound> 组件方式，但计划引入专门的 NotFound 页面支持，这将更好地与 UseStatusCodePagesWithReExecute 中间件配合工作，并支持交互式场景。

最佳实践建议

1. 对于新项目，建议采用中间件方式处理404
2. 对于迁移项目，可以使用上述过渡方案
3. 关注 .NET 10.0 的新特性，计划更优雅的解决方案
4. 区分API和页面请求的处理方式
5. 确保404页面提供良好的用户体验和导航选项

这种处理方式不仅适用于Blazor，也是现代ASP.NET Core应用处理未找到资源的推荐模式，体现了框架的一致性和灵活性。