ASP.NET Core中RenderViewAsync返回空值问题排查与解决

核心原因：未等待异步渲染完成 #

你调用的RenderAsync是异步方法，但代码里没有使用await等待它执行完成，导致StringWriter还没获取到视图渲染的内容就被提前读取并返回，最终得到空字符串。这是最关键的问题。

其他潜在问题 #

• 视图查找范围限制：FindView的第三个参数isMainPage设为false时，只会查找以_开头的部分视图。如果你的目标视图不是部分视图，需要将该参数改为true，或者改用GetView方法明确指定视图路径。
• 上下文对象传递异常：确保TempData在当前请求上下文内有效，ViewData.Model确实被正确赋值给目标视图。

修复后的代码 #

protected async Task<string> RenderViewAsync(string viewName, object model)
{
    if (string.IsNullOrEmpty(viewName))
    {
        viewName = ControllerContext.ActionDescriptor.ActionName;
    }

    ViewData.Model = model;

    using (var writer = new StringWriter())
    {
        var viewEngine = HttpContext.RequestServices.GetService<ICompositeViewEngine>();
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);

        if (!viewResult.Success)
        {
            return $"找不到名为 {viewName} 的视图";
        }

        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );

        await viewResult.View.RenderAsync(viewContext); // 必须添加await等待异步完成

        return writer.GetStringBuilder().ToString();
    }
}

使用注意 #

调用该方法时必须配合await关键字，例如在控制器的异步Action中：

public async Task<IActionResult> SomeAction()
{
    var model = new YourViewModel();
    var renderedHtml = await RenderViewAsync("YourViewName", model);
    // 后续处理渲染后的HTML
    return Content(renderedHtml);
}

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