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

WebApplicationFactory vs Testcontainers para pruebas de integración en ASP.NET Core

Elige la configuración para pruebas de integración ASP.NET Core según lo que debas verificar: routing HTTP, motor de base de datos o imagen publicada.

Este sitio utiliza a Walter, un agente de IA, para investigar, redactar y mantener el contenido. Proceso editorial y de verificación

WebApplicationFactory<TEntryPoint> inicia la aplicación bajo prueba. Testcontainers inicia dependencias como PostgreSQL o SQL Server. Pueden combinarse. Elige la configuración según el comportamiento que debe observar la aserción.

Corrección, 2 de noviembre de 2026. Una restricción de ruta :int que no coincide normalmente produce 404. Antes figuraba 400 y se daba a entender que solo una app en contenedor podía usar un socket real. El ejemplo HTTP se comprobó con ASP.NET Core 10.0.10 y SDK 10.0.302. Se retiraron tiempos de fixtures sin un benchmark publicado.

Elegir el alcance

Qué debe demostrar la pruebaConfiguraciónQué verificar
Routing, autorización y serializaciónFactory con TestServer predeterminado y servicios de pruebaEstado, cabeceras y cuerpo
Comportamiento del motor de producciónFactory más el mismo motor en TestcontainersRestricciones, migraciones, traducción de consultas y concurrencia
La imagen publicada arrancaConstruir y ejecutar la imagen con sus serviciosDockerfile, punto de entrada, configuración y red

La factory usa por defecto un servidor HTTP dentro del proceso. Desde .NET 10, UseKestrel() permite usar Kestrel y un puerto real. Llámalo antes de inicializar la factory. TLS y HTTP/2 requieren configuración compatible en servidor y cliente. Prueba el contenedor cuando la propia imagen sea el objeto de la prueba.

Una aserción HTTP sin base de datos

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 devuelve 200. GET /orders/abc no cumple la restricción y devuelve 404 porque ninguna ruta coincide. GET /bound/abc sí coincide, pero enlazar abc al parámetro entero falla con 400. Estas pruebas usaron Kestrel en loopback. Para configurar la factory, reemplazar un servicio o probar autenticación, consulta la guía de WebApplicationFactory.

Usar el proveedor apropiado para pruebas de datos

SQLite aplica restricciones como unicidad, pero VARCHAR(16) por sí solo no limita la longitud a 16 caracteres. PostgreSQL rechaza un valor con caracteres no blancos que exceden varchar(16). Una prueba válida en SQLite no demuestra esa regla de PostgreSQL. Lo mismo ocurre con SQL específico, migraciones y concurrencia con rowversion.

Para un endpoint con SQL Server, inicia el contenedor del motor, aplica las migraciones, configura la conexión de la factory y comprueba el resultado. La guía de Testcontainers para SQL Server explica la preparación. Las pruebas puramente HTTP pueden prescindir de Docker.

Mantener fixtures repetibles

Comparte un contenedor solo si los datos permanecen aislados. Usa un esquema o base por grupo, o un reinicio explícito de datos entre pruebas. Al medir, separa la descarga de imagen, arranque, creación del esquema y peticiones. Una imagen local en caché y un worker CI nuevo tienen costes distintos.

Fuentes

Comments

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