.NET 6中使用WebApplicationFactory的TestServer无法解析控制器的原因及解决方法

为什么会抛出InvalidOperationException？ #

你可能以为调用AddControllers()就会把控制器类注册到DI容器里，但其实不是——ASP.NET Core默认不会将控制器本身作为服务注册到依赖注入容器。AddControllers()方法只是注册了控制器运行所需的基础设施服务（比如控制器激活器、模型绑定器、过滤器等），控制器实例是由专门的IControllerActivator负责创建的，而不是直接从DI容器中获取。所以你直接调用GetRequiredService<MyController>()时，DI容器自然找不到对应的服务注册。

解决办法 #

下面提供几种可行的方案，你可以根据自己的调试需求选择：

方案1：手动将控制器注册到DI容器

如果只是想快速获取控制器实例来调试，可以在测试项目的WebApplicationFactory配置中，手动把控制器注册为瞬时服务：

var factory = new WebApplicationFactory<Program>().WithWebHostBuilder(builder =>
{
    builder.ConfigureServices(services =>
    {
        // 把目标控制器注册为瞬时服务
        services.AddTransient<MyController>();
    });
});

using var server = factory.Server;
var controller = server.Services.GetRequiredService<MyController>();
// 现在可以调试控制器了

注意：这种方式创建的控制器没有绑定请求上下文，如果你的控制器依赖HttpContext、RouteData等请求相关对象，可能还需要手动注入或模拟这些依赖。

方案2：使用控制器激活器创建实例（更贴近真实运行场景）

如果你希望模拟真实请求时控制器的创建逻辑，推荐使用ASP.NET Core内置的IControllerActivator来创建控制器实例，这样能保留完整的控制器上下文：

var factory = new WebApplicationFactory<Program>();
using var server = factory.Server;

// 获取控制器激活器
var activator = server.Services.GetRequiredService<IControllerActivator>();
// 创建控制器上下文（可以根据需要填充请求信息）
var controllerContext = new ControllerContext(
    new ActionContext(
        server.CreateHttpContext(), // 创建一个模拟的HttpContext
        new RouteData(),
        new ControllerActionDescriptor { ControllerName = nameof(MyController) }
    )
);

// 创建控制器实例
var controller = activator.Create(controllerContext) as MyController;
// 现在可以调试控制器，且上下文更贴近真实请求

这种方式创建的控制器和实际请求中创建的实例逻辑一致，调试时能更准确地复现运行时的情况。

方案3：单独做控制器单元测试（如果仅需调试业务逻辑）

如果你的调试目标只是控制器的业务逻辑，而非完整的集成流程，也可以直接创建控制器实例并Mock依赖：

// Mock控制器的依赖服务
var mockService = new Mock<IMyService>();
// 手动创建控制器实例
var controller = new MyController(mockService.Object);
// 直接调试控制器方法
var result = controller.MyAction();

这种方式更轻量化，适合快速验证控制器的业务逻辑。

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