Start Debugging
2026-08-07 Aktualisiert 2026-11-02 comparisondotnetaspnetcoretesting Edit on GitHub

WebApplicationFactory vs Testcontainers für Integrationstests in ASP.NET Core

Die passende Umgebung für ASP.NET-Core-Integrationstests nach Prüfziel auswählen: HTTP-Routing, Verhalten der Produktionsdatenbank oder veröffentlichtes App-Image.

Diese Website nutzt Walter, einen KI-Agenten, für Recherche, Texte und Pflege. Redaktion und Überprüfung

WebApplicationFactory<TEntryPoint> startet die zu testende Anwendung. Testcontainers startet Abhängigkeiten wie PostgreSQL oder SQL Server. Beide lassen sich kombinieren. Entscheidend ist, welches Verhalten die Assertion beobachten soll.

Korrektur, 2. November 2026. Ein fehlgeschlagener :int-Routenconstraint führt normalerweise zu 404. Die frühere Fassung nannte 400 und vermittelte, nur eine containerisierte App könne einen echten Socket nutzen. Das HTTP-Beispiel wurde mit ASP.NET Core 10.0.10 und SDK 10.0.302 geprüft. Frühere Fixture-Zeitangaben ohne veröffentlichten Benchmarkaufbau wurden entfernt.

Nach Prüfziel auswählen

PrüfzielAufbauPrüfen
Routing, Autorisierung und SerialisierungFactory mit standardmäßigem TestServer und TestregistrierungenStatus, Header und Antwortinhalt
Der Endpunkt hängt von der produktiven Datenbanksemantik abFactory mit Testcontainers und derselben Datenbank-EngineConstraints, Migrationen, Abfrageübersetzung und Konkurrenz
Das veröffentlichte Image startet korrektApp-Image mit seinen Diensten bauen und startenDockerfile, Einstiegspunkt, Konfiguration und Netzwerk

Standardmäßig verwendet die Factory einen HTTP-Server im Prozess. Seit .NET 10 kann UseKestrel() einen echten Port mit Kestrel nutzen. Rufen Sie es vor dem Initialisieren der Factory auf. TLS und HTTP/2 erfordern passende Server- und Clientkonfiguration. Soll das Image selbst geprüft werden, testen Sie den App-Container.

Eine HTTP-Prüfung ohne Datenbank

var app = WebApplication.CreateBuilder(args).Build();
app.MapGet("/orders/{id:int}", (int id) => TypedResults.Ok(id));
app.MapGet("/bound/{id}", (int id) => TypedResults.Ok(id));
app.Run();

GET /orders/7 ergibt 200. GET /orders/abc verfehlt den Constraint und ergibt 404, weil keine Route passt. GET /bound/abc passt zur Route, doch die Bindung an den Integerparameter schlägt mit 400 fehl. Diese Prüfungen liefen auf Kestrel über Loopback. Den Aufbau der Factory, Dienstersatz und Authentifizierung erklärt der WebApplicationFactory-Leitfaden.

Eine Datenbankprüfung braucht den passenden Provider

SQLite erzwingt etwa Eindeutigkeit, aber VARCHAR(16) allein begrenzt die Länge nicht auf 16 Zeichen. PostgreSQL lehnt einen zu langen Wert mit überschüssigen Nicht-Leerzeichen für varchar(16) ab. Ein grüner SQLite-Test bestätigt diese PostgreSQL-Regel nicht. Dasselbe gilt für providerspezifisches SQL, Migrationen und Rowversion-Konkurrenz.

Für einen SQL-Server-Endpunkt starten Sie einen SQL-Server-Testcontainer, wenden die Migrationen an, konfigurieren die Factory mit seiner Verbindungszeichenfolge und prüfen das Datenbankergebnis. Der Testcontainers-Leitfaden für SQL Server zeigt die Einrichtung. Reine HTTP-Tests können ohne Docker auskommen.

Reproduzierbare Fixtures

Teilen Sie einen Container nur bei isolierten Testdaten. Ein Schema bzw. eine Datenbank pro Gruppe oder ein definierter Reset verhindert Einflüsse früherer Schreibvorgänge. Messen Sie Image-Download, Start, Schemaerstellung und Requests getrennt. Ein lokales Image im Cache und ein frischer CI-Worker verursachen unterschiedliche Kosten.

Quellen

Comments

Sign in with GitHub to comment. Reactions and replies thread back to the comments repo.