如何在SignalR Hub中脱离控制器将分部视图渲染为字符串

适用场景 #

• 已通过SignalR实现客户端动态内容更新流程，核心链路为「服务端渲染分部视图为字符串 → Hub推送内容 → 客户端局部替换DOM」
• 已掌握控制器上下文中的分部视图字符串渲染方法，但SignalR Hub运行时无原生控制器上下文，无法直接复用原有渲染逻辑，需要适配无控制器场景的渲染实现

核心实现逻辑 #

ASP.NET Core的Razor视图渲染本质不强制依赖真实HTTP请求或控制器实例，仅需ActionContext、ViewContext对应的基础对象即可完成渲染，SignalR Hub可直接通过DI容器获取所需服务，手动构造无请求依赖的上下文对象完成渲染，具体步骤如下：

• 注册渲染依赖
  在项目的DI配置阶段（Program.cs或Startup.cs），将视图渲染所需的核心服务加入容器：

  // 注册视图渲染所需的核心服务
  builder.Services.AddRazorPages();
  builder.Services.AddScoped<IPartialViewRenderService, PartialViewRenderService>();
  

• 封装独立视图渲染服务
  编写可跨场景调用的渲染服务，不绑定当前请求的HttpContext，核心逻辑为：
  1. 从DI容器获取IRazorViewEngine、ITempDataProvider、IServiceProvider核心依赖
  2. 手动构造无真实请求绑定的DefaultHttpContext实例，将DI服务提供器挂载到上下文的RequestServices属性上
  3. 基于手动生成的HttpContext构造空路由的ActionContext，无需匹配真实控制器的路由规则
  4. 通过Razor视图引擎定位目标分部视图路径
  5. 初始化ViewContext，将视图模型、临时数据、输出写入流绑定到上下文，执行视图渲染后将流内容转为字符串返回

  服务核心代码示例

  public class PartialViewRenderService
  {
      private readonly IRazorViewEngine _viewEngine;
      private readonly ITempDataProvider _tempDataProvider;
      private readonly IServiceProvider _serviceProvider;
      public PartialViewRenderService(
          IRazorViewEngine viewEngine,
          ITempDataProvider tempDataProvider,
          IServiceProvider serviceProvider)
      {
          _viewEngine = viewEngine;
          _tempDataProvider = tempDataProvider;
          _serviceProvider = serviceProvider;
      }
      public async Task<string> RenderAsync<TModel>(string viewPath, TModel model)
      {
          // 构造无真实请求的HttpContext
          var httpContext = new DefaultHttpContext
          {
              RequestServices = _serviceProvider
          };
          // 构造空路由的ActionContext
          var actionContext = new ActionContext(
              httpContext,
              new RouteData(),
              new ActionDescriptor()
          );
          // 定位分部视图
          var viewResult = _viewEngine.GetView(
              executingFilePath: "~/", 
              viewPath: viewPath, 
              isMainPage: false);
          if (!viewResult.Success)
          {
              throw new InvalidOperationException($"未找到对应分部视图：{viewPath}");
          }
          // 准备视图输出上下文
          using var writer = new StringWriter();
          var viewContext = new ViewContext(
              actionContext,
              viewResult.View,
              new ViewDataDictionary<TModel>(
                  new EmptyModelMetadataProvider(), 
                  new ModelStateDictionary())
              {
                  Model = model
              },
              new TempDataDictionary(httpContext, _tempDataProvider),
              writer,
              new HtmlHelperOptions()
          );
          // 执行渲染
          await viewResult.View.RenderAsync(viewContext);
          return writer.ToString();
      }
  }
  

• 在SignalR Hub中调用渲染服务
  通过构造函数注入的方式拿到封装好的IPartialViewRenderService，在需要推送动态内容的业务逻辑中，传入分部视图路径、对应视图模型，拿到渲染完成的字符串后，通过Hub的客户端推送方法发送到前端即可，无需关联任何控制器实例。

常见注意事项 #

• 视图路径规则：脱离真实控制器路由上下文后，定位分部视图需写全从Views根目录开始的相对路径（如~/Views/Shared/_NotificationItem.cshtml），不要依赖控制器路由的短路径匹配规则，否则会出现视图找不到的异常
• 上下文依赖限制：手动构造的HttpContext无真实请求数据，不要在分部视图中直接读取当前请求的Header、路由值、查询参数，所有视图需要用到的参数需通过视图模型显式传入
• 作用域匹配：若渲染服务依赖Scoped生命周期的服务，需在调用时手动创建DI作用域，避免将Scoped服务捕获到Singleton对象中造成生命周期冲突
• TempData适配：如果分部视图中使用了TempData，需确保挂载的TempDataProvider具备可持久化的存储能力，避免因无会话上下文导致的读写异常

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