ASP.NET WebAPI Minimal拆分Program.cs到Startup.cs做集成测试遇编译错误

• 拆分Startup.cs的方向是可行的，Minimal API完全可以使用Startup.cs结构，核心是要适配Minimal API的端点配置逻辑。

• 你遇到的编译错误原因很明确：MapGroup是IEndpointRouteBuilder接口的扩展方法，不能直接在IApplicationBuilder实例上调用。正确的做法是把端点配置（包括MapGroup、MapGet这类路由方法）放到UseEndpoints委托里，因为UseEndpoints的参数就是IEndpointRouteBuilder。

• 给你一个适配Minimal API的Startup.cs示例：

public class Startup
{
    public IConfiguration Configuration { get; }

    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    // 注册服务，测试时可以在TestStartup里重写这个方法替换模拟服务
    public void ConfigureServices(IServiceCollection services)
    {
        // 注册真实服务，比如数据库上下文、业务服务等
        services.AddDbContext<AppDbContext>(options =>
            options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));
        services.AddScoped<IProductService, ProductService>();
    }

    // 配置中间件和端点
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.UseHttpsRedirection();
        app.UseRouting(); // 必须先调用UseRouting

        // 在这里配置Minimal API端点，用UseEndpoints拿到IEndpointRouteBuilder
        app.UseEndpoints(endpoints =>
        {
            var productGroup = endpoints.MapGroup("/api/products");
            productGroup.MapGet("/", (IProductService service) => service.GetAllProducts());
            productGroup.MapGet("/{id}", (int id, IProductService service) => service.GetProductById(id));
        });
    }
}

• 对应的TestStartup可以这样写，替换真实服务为模拟实现：

public class TestStartup : Startup
{
    public TestStartup(IConfiguration configuration) : base(configuration)
    {
    }

    public override void ConfigureServices(IServiceCollection services)
    {
        // 先调用base方法注册基础服务，再替换需要模拟的服务
        base.ConfigureServices(services);
        services.Replace(new ServiceDescriptor(typeof(IProductService), typeof(MockProductService), ServiceLifetime.Scoped));
    }
}

• 额外说明：其实Minimal API默认的Program.cs写法也能实现测试服务替换，不需要强制拆分Startup.cs。比如使用WebApplicationFactory时，可以通过WithWebHostBuilder来修改服务配置：

var factory = new WebApplicationFactory<Program>()
    .WithWebHostBuilder(builder =>
    {
        builder.ConfigureServices(services =>
        {
            services.Replace(new ServiceDescriptor(typeof(IProductService), typeof(MockProductService), ServiceLifetime.Scoped));
        });
    });

这种方式更贴合Minimal API的原生写法，但拆分Startup.cs也是完全合理的方案，适合习惯传统Startup结构的开发者。

内容的提问来源于stack exchange，提问作者Hung P.T.