ASP.NET Core Minimal APIs oder Controller in .NET 10

Wenn Sie eine neue Web-API in .NET 10starten, ist die erste Weggabelung zugleich eine der folgenreichsten: Minimal APIs oder Controller? Beide sind erstklassig, beide werden voll unterstützt, und mit beiden lassen sich ernsthafte Produktionsdienste bauen. Die Frage ist nicht, was abstrakt „besser“ ist, sondern was zur Form Ihres Projekts, Ihres Teams und zu Ihren Erwartungen an das Code-Wachstum passt. Dieser Leitfaden ist ein Entscheidungsrahmen, keine Siegererklärung: wie die beiden Modelle arbeiten, wo jedes glänzt und wie Sie ohne Reue wählen.

Die beiden Modelle in Kürze

Controller sind der seit Langem etablierte MVC-Ansatz: Endpunkte sind Methoden auf Klassen, die von einem Basis-Controller erben, nach Konvention gruppiert, mit Attributen für Routing und Verhalten. Minimal APIs, die später eingeführt und stetig ausgebaut wurden, erlauben es, Endpunkte direkt als Route-Handler zu definieren: typischerweise Lambda- oder Methodenreferenzen, die mit weit weniger Zeremonie und ohne verpflichtende Klassenhierarchie auf Routen abgebildet werden.

// Minimal API: the endpoint is the mapping.
app.MapGet("/products/{id:int}", async (int id, IProductService svc) =>
    await svc.Find(id) is { } p ? Results.Ok(p) : Results.NotFound());

// Controller: the endpoint is a method on a class.
[ApiController]
[Route("products")]
public class ProductsController(IProductService svc) : ControllerBase
{
    [HttpGet("{id:int}")]
    public async Task<IActionResult> Get(int id) =>
        await svc.Find(id) is { } p ? Ok(p) : NotFound();
}

Warum die Lücke kleiner geworden ist

Anfangs waren Minimal APIs wirklich minimal: gut für kleine Dienste, aber es fehlten Bausteine, die man im großen Maßstab braucht, was Teams zurück zu Controllern trieb. Mit jedem Release hat sich diese Lücke geschlossen. Minimal APIs beherrschen jetzt Dinge, die früher nur Controllern vorbehalten waren: robustes Model Binding, Validierung, Gruppierung verwandter Endpunkte, Filter für übergreifende Belange und saubere OpenAPI-Generierung. In .NET 10 sind sie ein glaubwürdiger Standard für umfangreiche APIs, nicht nur für Spielzeugprojekte.

Wo Minimal APIs glänzen

Wo Controller nach wie vor ihre Berechtigung haben

Minimal APIs vor dem Chaos bewahren

Der häufigste Einwand gegen Minimal APIs: „sie skalieren nicht für große Apps“: ist in Wirklichkeit ein Einwand gegen undisziplinierte Minimal APIs. Die Lösung ist Struktur: Werfen Sie nicht alle Endpunkte in eine Datei. Gruppieren Sie verwandte Endpunkte in Route Groups, extrahieren Sie Handler in benannte Methoden oder kleine Klassen und registrieren Sie sie über Erweiterungsmethoden, damit Ihr Anwendungsstart lesbar bleibt.

// Organise endpoints by feature, registered via extension methods.
public static class ProductEndpoints
{
    public static IEndpointRouteBuilder MapProducts(this IEndpointRouteBuilder app)
    {
        var group = app.MapGroup("/products").WithTags("Products");
        group.MapGet("/{id:int}", GetProduct);
        group.MapPost("/", CreateProduct);
        return group;
    }
    // handlers as named methods, not anonymous lambdas, for testability
}

// Program.cs stays clean:
app.MapProducts();
app.MapOrders();

Der Entscheidungsrahmen

Sie können sie sogar mischen

In ASP.NET Core können Controller und Minimal APIs in derselben Anwendung koexistieren. Das ist praktisch bei einer schrittweisen Migration oder wenn ein Stil für einen Teil der App besser passt als der andere. Setzen Sie das sparsam und bewusst ein: eine Codebasis, die ohne klaren Grund zwischen zwei Endpunktstilen aufgeteilt ist, erschwert nur den Einstieg. Wählen Sie ein primäres Modell und lassen Sie die Ausnahmen echte Ausnahmen sein.