如何下载Blazor Server页面的HTML结果？迁移MVC后遇加载异常

Blazor Server页面依赖SignalR连接完成组件的交互式渲染。当你在服务器端通过HttpClient直接请求Blazor页面时，没有经过浏览器端的SignalR握手与初始化流程，Blazor无法完成组件渲染，因此返回的是未初始化的初始加载页面（即你看到的Loading... An unhandled exception has occurred内容）。

以下是几种可行的解决思路，按推荐程度排序：

1. 直接在服务器端渲染Blazor组件为HTML（推荐） #

不需要通过HTTP请求绕圈，直接在服务器端将目标Blazor组件渲染为HTML字符串，完全避开SignalR依赖问题。

实现示例（.NET 8+） #

利用HtmlRenderer直接渲染组件：

using Microsoft.AspNetCore.Components;
using Microsoft.AspNetCore.Components.Rendering;
using System.Collections.Generic;

public class ComponentRendererService
{
    private readonly IServiceProvider _serviceProvider;

    public ComponentRendererService(IServiceProvider serviceProvider)
    {
        _serviceProvider = serviceProvider;
    }

    public async Task<string> RenderComponentToHtmlAsync<TComponent>(Dictionary<string, object?> parameters = null)
        where TComponent : IComponent
    {
        var renderer = new HtmlRenderer(_serviceProvider);
        var parameterView = parameters != null ? ParameterView.FromDictionary(parameters) : ParameterView.Empty;
        var renderFragment = await renderer.RenderComponentAsync<TComponent>(parameterView);
        return renderFragment.ToHtmlString();
    }
}

使用方式 #

在需要生成邮件正文的地方注入ComponentRendererService，直接调用方法获取HTML：

var htmlContent = await _componentRenderer.RenderComponentToHtmlAsync<YourEmailComponent>(
    new Dictionary<string, object?>
    {
        { "OrderId", order.Id },
        { "CustomerName", order.CustomerName }
    });

2. 使用纯静态Razor页面（.cshtml）生成邮件内容 #

如果邮件内容不需要Blazor的交互式功能，改用纯服务器渲染的Razor页面（不包含任何Blazor组件）。这类页面直接由ASP.NET Core渲染为HTML，服务器端HttpClient请求可以正常获取完整渲染后的内容。

确保你的Razor页面没有引用Blazor相关的脚本或组件，直接返回静态HTML即可。

3. 模拟浏览器请求上下文（不推荐） #

如果必须通过HTTP请求获取内容，需要在HttpClient请求中模拟浏览器的完整上下文，包括：

• 传递正确的Cookie（如果涉及身份验证）
• 处理SignalR握手流程
• 等待组件渲染完成

这种方式复杂度极高，维护成本大，不建议采用。

你当前的HTTP请求代码本身没有语法问题，但忽略了Blazor Server的渲染机制——Blazor页面不是一次性渲染的静态HTML，需要客户端与服务器建立SignalR连接后才能完成组件渲染，因此服务器端直接请求无法得到最终渲染结果。

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