Blazor Server（Server渲染模式）下404页面返回200状态码的解决办法咨询

针对Server渲染模式下Blazor NotFound页面返回200状态码的问题，以下是两个可行的临时解决思路：

方案一：服务器端预检查Blazor路由，主动设置404状态码 #

核心逻辑是在请求进入Blazor渲染流程前，先验证请求路径是否匹配已注册的Blazor路由，不匹配则直接设置404状态码，同时保留Blazor的NotFound页面渲染逻辑。

实现步骤： #

1. 在Program.cs中获取所有已注册的Blazor页面路由
2. 添加自定义中间件，拦截非静态资源、API的请求，判断路径是否匹配Blazor路由
3. 对不匹配的请求设置404状态码

代码示例：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();

var app = builder.Build();

// 获取所有Blazor页面的路由规则
var endpointDataSource = app.Services.GetRequiredService<EndpointDataSource>();
var blazorRoutePatterns = endpointDataSource.Endpoints
    .OfType<RouteEndpoint>()
    .Where(e => e.Metadata.OfType<PageRouteMetadata>().Any())
    .Select(e => e.RoutePattern)
    .ToList();

// 自定义中间件处理404状态码
app.Use(async (context, next) =>
{
    var requestPath = context.Request.Path.Value;

    // 跳过静态资源、框架文件和API请求的检查
    if (!requestPath.StartsWith("/_content") && 
        !requestPath.StartsWith("/_framework") && 
        !requestPath.StartsWith("/api"))
    {
        bool routeMatched = false;
        foreach (var pattern in blazorRoutePatterns)
        {
            if (RoutePatternMatcher.TryMatch(pattern, requestPath, out _))
            {
                routeMatched = true;
                break;
            }
        }

        if (!routeMatched)
        {
            context.Response.StatusCode = StatusCodes.Status404NotFound;
        }
    }

    await next();
});

app.UseStaticFiles();
app.UseRouting();
app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

app.Run();

注意事项： #

• 该方案支持静态路由和带参数的动态路由（如/Product/{Id}）
• 若应用使用了通配符路由（如/{*catchall}），需单独处理，避免误判所有未匹配路由为404

方案二：通过状态服务标记404，在_Host中设置状态码 #

通过Scoped服务存储请求状态，在NotFound组件中标记404，再在_Host.cshtml中读取标记并设置响应状态码。

实现步骤： #

1. 创建Scoped服务用于存储请求状态
2. 在NotFound组件中注入服务并标记404
3. 在_Host.cshtml中读取标记设置状态码

代码示例：

1. 创建状态标记服务

public class RequestStatusService
{
    public int? StatusCode { get; set; }
}

2. 在Program.cs中注册服务

builder.Services.AddScoped<RequestStatusService>();

3. 修改NotFound组件

@inject RequestStatusService StatusService

<NotFound>
    <PageTitle>Not Found</PageTitle>
    <LayoutView Layout="@typeof(Error404Layout)">
        <h4>Not Found</h4>
    </LayoutView>
    <HeadContent>
        <meta name="robots" content="noindex" />
    </HeadContent>
</NotFound>

@code {
    protected override void OnInitialized()
    {
        StatusService.StatusCode = 404;
        base.OnInitialized();
    }
}

4. 修改_Host.cshtml

@inject RequestStatusService StatusService

@{
    if (StatusService.StatusCode.HasValue)
    {
        Context.Response.StatusCode = StatusService.StatusCode.Value;
    }
}

<!DOCTYPE html>
<html lang="en">
<!-- 原有_Host内容 -->
</html>

注意事项： #

• 仅对初始HTTP请求有效，客户端导航不会修改状态码
• 对SEO帮助有限，部分搜索引擎仅识别服务器端返回的状态码

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