Start Debugging
RU
2026-08-07 Обновлено 2026-11-02 comparisondotnetaspnetcoretesting Edit on GitHub

WebApplicationFactory против Testcontainers для интеграционных тестов в ASP.NET Core

Выбирайте среду интеграционных тестов ASP.NET Core по проверяемому поведению: маршрутизация HTTP, производственная СУБД или опубликованный образ приложения.

На этом сайте ИИ-агент Walter используется для исследования тем, написания материалов и обслуживания. Подготовка и проверка материалов

WebApplicationFactory<TEntryPoint> запускает тестируемое приложение. Testcontainers запускает зависимости, например PostgreSQL или SQL Server. Их можно использовать вместе. Выбирайте конфигурацию по поведению, которое должна проверить ассерция.

Исправление, 2 ноября 2026 года. Несовпадение с ограничением маршрута :int обычно даёт 404. Ранее был указан 400 и утверждалось, что реальный сокет возможен только в контейнере приложения. Пример HTTP проверен на ASP.NET Core 10.0.10 и SDK 10.0.302. Удалены замеры фикстур без опубликованного бенчмарка.

Выбор границ проверки

Что должен доказать тестКонфигурацияЧто проверить
Маршрутизация, авторизация и сериализацияFactory с обычным TestServer и тестовыми сервисамиСтатус, заголовки и тело ответа
Поведение производственной СУБДFactory и тот же движок через TestcontainersОграничения, миграции, трансляция запросов и конкуренция
Опубликованный образ запускаетсяСборка и запуск образа приложения с сервисамиDockerfile, точка входа, параметры и сеть

По умолчанию factory использует HTTP-сервер внутри процесса. С .NET 10 вызов UseKestrel() до инициализации factory позволяет использовать Kestrel и настоящий порт. Для TLS и HTTP/2 нужна соответствующая настройка сервера и клиента. Если тестируется сам образ, запускайте контейнер приложения.

Проверка HTTP без базы данных

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 возвращает 200. GET /orders/abc не проходит ограничение, и ни один маршрут не совпадает, поэтому результат — 404. GET /bound/abc совпадает с маршрутом, но привязка к целочисленному параметру завершается ответом 400. Это проверено по loopback на Kestrel. Настройка factory, подмена сервисов и тесты аутентификации описаны в руководстве по WebApplicationFactory.

Проверка базы требует подходящего провайдера

SQLite проверяет, например, уникальность, но VARCHAR(16) сам по себе не ограничивает длину 16 символами. PostgreSQL отклоняет значение с лишними непробельными символами за пределом varchar(16). Успешный тест SQLite не подтверждает эту особенность PostgreSQL. То же относится к SQL провайдера, миграциям и конкуренции с rowversion.

Для конечной точки с SQL Server запустите контейнер SQL Server, примените миграции, укажите factory его строку подключения и проверьте результат. Настройка разобрана в руководстве Testcontainers для SQL Server. Чистые HTTP-тесты могут обходиться без Docker.

Воспроизводимые фикстуры

Делите контейнер между тестами только при изоляции данных. Отдельная схема или база на группу либо явный сброс предотвращают влияние прежних записей. Измеряйте загрузку образа, запуск, создание схемы и запросы отдельно. Локальный кэш и новый CI-воркер имеют разные затраты.

Источники

Comments

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