.NET 8 Blazor中间件：如何区分静态与交互式服务器渲染请求

核心问题 #

在.NET 8 Blazor Web App中，需要为**静态服务器渲染(SSR)和交互式服务器渲染(InteractiveServer)**场景生成唯一Nonce并存入HttpContext.Items，但当前基于路径过滤的实现需要不断维护排除列表，扩展性差。

优化方案：利用ASP.NET Core内置特性与Blazor元数据判断 #

通过检查请求的Endpoint元数据和ASP.NET Core的内置Feature，替代路径过滤，实现无需维护排除列表的可靠判断逻辑。

实现代码 #

using Microsoft.AspNetCore.Components.Endpoints;
using Microsoft.AspNetCore.Http.Features;

public class NonceMiddleware
{
    private readonly RequestDelegate _next;

    public NonceMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        string nonce = Guid.NewGuid().ToString();

        if (IsInteractiveServerRequest(context))
        {
            context.Items.Add("MyInteractiveNonce", nonce);
            context.Response.OnStarting(() => OnStartingCallBackInteractiveRequest(context, nonce));
        }
        else if (IsStaticServerRenderedPageRequest(context))
        {
            context.Items.Add("MyStaticNonce", nonce);
            context.Response.OnStarting(() => OnStartingCallBackStaticRequest(context, nonce));
        }

        await _next(context);
    }

    private bool IsInteractiveServerRequest(HttpContext context)
    {
        // 判断是否为Blazor Hub的WebSocket连接请求（InteractiveServer核心通信通道）
        if (context.WebSockets.IsWebSocketRequest && context.Request.Path.Equals("/_blazor"))
            return true;

        // 判断Endpoint是否携带InteractiveServer渲染模式的元数据
        var interactiveMetadata = context.GetEndpoint()?.Metadata.GetMetadata<InteractiveRenderModeMetadata>();
        return interactiveMetadata?.RenderMode is Microsoft.AspNetCore.Components.Web.InteractiveServerRenderMode;
    }

    private bool IsStaticServerRenderedPageRequest(HttpContext context)
    {
        // 排除非GET请求与WebSocket请求
        if (!context.Request.Method.Equals("GET", StringComparison.OrdinalIgnoreCase) || context.WebSockets.IsWebSocketRequest)
            return false;

        // 排除静态资源请求（JS/CSS/图片等，由静态文件中间件处理）
        if (context.Features.Get<IStaticFileFeature>() != null)
            return false;

        // 判断是否为Blazor静态渲染的页面请求（无指定交互式渲染模式）
        var componentMetadata = context.GetEndpoint()?.Metadata.GetMetadata<ComponentEndpointMetadata>();
        return componentMetadata != null && componentMetadata.RenderMode == null;
    }

    // 保留原有的OnStarting回调逻辑
    private Task OnStartingCallBackInteractiveRequest(HttpContext context, string nonce)
    {
        // 你的交互式请求回调逻辑
        return Task.CompletedTask;
    }

    private Task OnStartingCallBackStaticRequest(HttpContext context, string nonce)
    {
        // 你的静态渲染请求回调逻辑
        return Task.CompletedTask;
    }
}

关键逻辑说明 #

1. 交互式服务器请求判断

   • 优先识别Blazor Hub的WebSocket连接（/_blazor路径的WebSocket请求），这是InteractiveServer模式下实时通信的核心通道。
   • 通过InteractiveRenderModeMetadata判断请求对应的页面是否使用InteractiveServer渲染模式，精准匹配交互式场景。

2. 静态SSR请求判断

   • 先排除非GET请求和WebSocket请求，缩小范围。
   • 通过IStaticFileFeature自动识别所有静态资源请求（包括Blazor内置的/_framework资源、自定义JS/CSS等），无需手动维护路径列表。
   • 通过ComponentEndpointMetadata判断是否为Blazor页面请求，且RenderMode为null（默认静态渲染模式），确保仅针对静态SSR页面生成Nonce。

优势 #

• 无需维护排除列表：静态资源、Blazor内置请求会被自动识别排除，新增资源时无需修改代码。
• 精准匹配场景：基于Blazor的渲染模式元数据和ASP.NET Core核心特性，判断逻辑更可靠，不会出现误判。

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