如何在.NET中编写单元测试断言控制器Action返回的HTML内容？

你可以通过两种核心方式实现无需部署即可测试控制器返回的HTML内容：一种是手动利用ASP.NET Core的视图引擎渲染ViewResult，另一种是用官方集成测试库在内存中模拟请求。

方法一：手动渲染ViewResult（单元测试场景） #

这种方式直接操作视图引擎，适合聚焦测试视图渲染逻辑，无需启动完整应用。

步骤与代码示例 #

1. 安装必要的NuGet包：

   Install-Package Microsoft.AspNetCore.Mvc.ViewFeatures
   Install-Package Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation
   Install-Package Microsoft.Extensions.DependencyInjection
   

2. 编写测试代码：

   using Microsoft.AspNetCore.Mvc;
   using Microsoft.AspNetCore.Mvc.Razor;
   using Microsoft.AspNetCore.Mvc.ViewEngines;
   using Microsoft.AspNetCore.Mvc.ViewFeatures;
   using Microsoft.Extensions.DependencyInjection;
   using System.IO;
   using Xunit;
   
   public class HomeControllerTests
   {
       [Fact]
       public async Task Index_RendersHtmlWithExpectedH1()
       {
           // 1. 构建测试用服务集合
           var services = new ServiceCollection();
           services.AddMvc()
               .AddRazorRuntimeCompilation() // 启用运行时编译，避免预编译视图依赖
               .AddApplicationPart(typeof(HomeController).Assembly); // 关联控制器所在程序集
   
           // 配置视图查找路径，替换为你的Web项目Views文件夹相对路径
           services.Configure<RazorViewEngineOptions>(options =>
           {
               options.ViewLocationFormats.Add("/../YourWebApp/Views/{1}/{0}.cshtml");
               options.ViewLocationFormats.Add("/../YourWebApp/Views/Shared/{0}.cshtml");
           });
   
           var serviceProvider = services.BuildServiceProvider();
   
           // 2. 获取视图引擎和TempData服务
           var viewEngine = serviceProvider.GetRequiredService<ICompositeViewEngine>();
           var tempDataProvider = serviceProvider.GetRequiredService<ITempDataProvider>();
   
           // 3. 初始化控制器上下文
           var controller = new HomeController();
           var actionContext = new ActionContext(
               new DefaultHttpContext { RequestServices = serviceProvider },
               new Microsoft.AspNetCore.Routing.RouteData(),
               controller.ControllerContext.ActionDescriptor);
   
           controller.ControllerContext = new ControllerContext(actionContext);
   
           // 4. 调用Action获取ViewResult
           var result = controller.Index() as ViewResult;
   
           // 5. 查找并渲染视图
           var viewEngineResult = viewEngine.FindView(actionContext, result.ViewName, isMainPage: true);
           if (!viewEngineResult.Success)
           {
               throw new InvalidOperationException($"视图 {result.ViewName} 未找到");
           }
   
           var viewContext = new ViewContext(
               actionContext,
               viewEngineResult.View,
               result.ViewData,
               result.TempData,
               TextWriter.Null,
               new HtmlHelperOptions());
   
           using var stringWriter = new StringWriter();
           viewContext.Writer = stringWriter;
           await viewEngineResult.View.RenderAsync(viewContext);
           var renderedHtml = stringWriter.ToString();
   
           // 6. 断言HTML内容
           Assert.Contains("<h1>欢迎访问首页</h1>", renderedHtml);
       }
   }
   

关键注意事项 #

• 视图路径要根据你的项目结构调整，确保测试程序能访问到Web项目的Views文件夹
• 启用运行时编译可以避免预编译视图带来的依赖问题
• 确保ViewResult的ViewData包含正确的模型数据，否则渲染出的HTML会不符合预期

方法二：用Mvc.Testing进行集成测试（完整请求场景） #

官方的Microsoft.AspNetCore.Mvc.Testing库会在内存中托管应用，模拟真实HTTP请求，无需部署，速度快且稳定，适合测试完整的请求管道。

步骤与代码示例 #

1. 安装NuGet包：

   Install-Package Microsoft.AspNetCore.Mvc.Testing
   

2. 编写测试代码：

   using Microsoft.AspNetCore.Mvc.Testing;
   using Xunit;
   
   public class HomeIntegrationTests : IClassFixture<WebApplicationFactory<Program>>
   {
       private readonly HttpClient _httpClient;
   
       public HomeIntegrationTests(WebApplicationFactory<Program> factory)
       {
           _httpClient = factory.CreateClient();
       }
   
       [Fact]
       public async Task IndexPage_ContainsExpectedH1Tag()
       {
           // 发送GET请求到目标Action
           var response = await _httpClient.GetAsync("/Home/Index");
           response.EnsureSuccessStatusCode(); // 确保请求成功
   
           // 读取响应的HTML内容
           var htmlContent = await response.Content.ReadAsStringAsync();
   
           // 断言HTML包含指定内容
           Assert.Contains("<h1>欢迎访问首页</h1>", htmlContent);
       }
   }
   

优势说明 #

• 自动处理视图查找、依赖注入、路由等所有ASP.NET Core运行时细节
• 模拟真实请求流程，测试覆盖更完整
• 无需手动配置视图路径，减少维护成本

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