使用xUnit+Moq测试控制器时遇ITempDataDictionaryFactory未注册异常

异常原因 #

当控制器返回ViewResult时，ASP.NET Core MVC框架需要ITempDataDictionaryFactory服务处理TempData相关逻辑。手动模拟HttpContext时未向控制器的服务容器注册该服务，因此抛出未注册异常。

解决方案 #

方案1：手动模拟必要服务（纯单元测试） #

通过Moq模拟HttpContext、TempData相关服务，并配置控制器的上下文和服务提供者：

using Xunit;
using Moq;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.ViewFeatures;
using Microsoft.AspNetCore.Identity;

public class AccountControllerTests
{
    [Fact]
    public async Task Login_InvokesSignOutAndReturnsViewWithReturnUrl()
    {
        // 模拟HttpContext及SignOutAsync方法
        var httpContextMock = new Mock<HttpContext>();
        httpContextMock.Setup(ctx => ctx.SignOutAsync(
                IdentityConstants.ExternalScheme, 
                It.IsAny<AuthenticationProperties>()
            ))
            .Returns(Task.CompletedTask);

        // 模拟TempData相关服务
        var tempDataMock = new Mock<ITempDataDictionary>();
        var tempDataFactoryMock = new Mock<ITempDataDictionaryFactory>();
        tempDataFactoryMock.Setup(f => f.GetTempData(httpContextMock.Object))
            .Returns(tempDataMock.Object);

        // 模拟服务提供者，注册TempData工厂
        var serviceProviderMock = new Mock<IServiceProvider>();
        serviceProviderMock.Setup(sp => sp.GetService(typeof(ITempDataDictionaryFactory)))
            .Returns(tempDataFactoryMock.Object);

        // 初始化控制器并配置上下文
        var controller = new AccountController(); // 替换为你的实际控制器类
        controller.ControllerContext = new ControllerContext
        {
            HttpContext = httpContextMock.Object
        };
        controller.ControllerContext.HttpContext.RequestServices = serviceProviderMock.Object;

        // 执行测试方法
        var result = await controller.Login("/dashboard");

        // 断言验证
        var viewResult = Assert.IsType<ViewResult>(result);
        Assert.Equal("/dashboard", viewResult.ViewData["ReturnUrl"]);
        httpContextMock.Verify(ctx => ctx.SignOutAsync(
                IdentityConstants.ExternalScheme, 
                It.IsAny<AuthenticationProperties>()
            ), 
            Times.Once
        );
    }
}

方案2：使用Mvc.Testing包（减少手动模拟） #

如果不想手动模拟大量MVC依赖，可使用Microsoft.AspNetCore.Mvc.Testing包，它会自动配置MVC所需的全部服务：

1. 安装NuGet包：

dotnet add package Microsoft.AspNetCore.Mvc.Testing

2. 编写测试代码：

using Xunit;
using Microsoft.AspNetCore.Mvc.Testing;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.DependencyInjection;
using Moq;
using Microsoft.AspNetCore.Identity;

public class AccountControllerTests : IClassFixture<WebApplicationFactory<Program>>
{
    private readonly WebApplicationFactory<Program> _factory;

    public AccountControllerTests(WebApplicationFactory<Program> factory)
    {
        _factory = factory.WithWebHostBuilder(builder =>
        {
            builder.ConfigureServices(services =>
            {
                // 替换SignInManager为模拟实现（按需调整）
                var signInManagerService = services.FirstOrDefault(d => d.ServiceType == typeof(SignInManager<IdentityUser>));
                if (signInManagerService != null)
                {
                    services.Remove(signInManagerService);
                    services.AddScoped(_ => Mock.Of<SignInManager<IdentityUser>>());
                }
            });
        });
    }

    [Fact]
    public async Task Login_ReturnsViewWithCorrectReturnUrl()
    {
        // 获取控制器实例
        var controller = _factory.Services.GetRequiredService<AccountController>();
        controller.ControllerContext = new ControllerContext
        {
            HttpContext = _factory.Server.CreateHttpContext()
        };

        // 执行测试
        var result = await controller.Login("/profile");

        // 断言
        var viewResult = Assert.IsType<ViewResult>(result);
        Assert.Equal("/profile", viewResult.ViewData["ReturnUrl"]);
    }
}

说明 #

• 方案1适合纯单元测试场景，可精准控制每个依赖的行为
• 方案2更适合需要完整MVC上下文的测试，能大幅减少手动模拟的工作量

内容的提问来源于stack exchange，提问作者KA-Yasso