Testes de integração
O teste que sobe a API inteira em memória, com banco de verdade num container, e faz requisições HTTP como um cliente faria. Pega o que o teste unitário não vê: a rota errada, a serialização, o mapeamento do EF Core, a migration, a autorização.
O que você precisa
dotnet add package Microsoft.AspNetCore.Mvc.Testing
dotnet add package Testcontainers.MsSql
A API precisa expor o Program para o projeto de teste. Com top-level statements, uma linha no fim do Program.cs:
public partial class Program { }
A fábrica da aplicação
public sealed class ApiFactory : WebApplicationFactory<Program>, IAsyncLifetime
{
private readonly MsSqlContainer _sql = new MsSqlBuilder()
.WithImage("mcr.microsoft.com/mssql/server:2022-latest")
.Build();
protected override void ConfigureWebHost(IWebHostBuilder builder)
{
builder.UseEnvironment("Testing");
builder.ConfigureTestServices(services =>
{
services.RemoveAll<DbContextOptions<AppDbContext>>();
services.AddDbContext<AppDbContext>(o => o.UseSqlServer(_sql.GetConnectionString()));
// O que sai do processo e não está no container vira dublê
services.RemoveAll<IEmailService>();
services.AddSingleton<IEmailService, EmailServiceFake>();
});
}
public async Task InitializeAsync()
{
await _sql.StartAsync();
using var scope = Services.CreateScope();
await scope.ServiceProvider.GetRequiredService<AppDbContext>().Database.MigrateAsync();
}
// Implementação explícita: o DisposeAsync da própria fábrica (que derruba a API) continua sendo chamado
async Task IAsyncLifetime.DisposeAsync()
{
await base.DisposeAsync();
await _sql.DisposeAsync();
}
}
O container sobe uma vez para a classe de teste (IClassFixture) ou para a coleção inteira (ICollectionFixture), não uma vez por teste.
O teste
Os testes abaixo exercitam os endpoints de ASP.NET Core na prática: POST /pedidos valida com FluentValidation e devolve 201 com o header Location.
public class PedidosEndpointsTests(ApiFactory factory) : IClassFixture<ApiFactory>
{
private readonly HttpClient _client = factory.CreateClient();
[Fact]
public async Task Post_PedidoValido_Retorna201ComLocation()
{
var request = new CreateOrderRequest("cliente-1", [new("sku-1", 10m, 2)]);
var resposta = await _client.PostAsJsonAsync("/pedidos", request);
Assert.Equal(HttpStatusCode.Created, resposta.StatusCode);
Assert.NotNull(resposta.Headers.Location);
var criado = await _client.GetFromJsonAsync<PedidoResponse>(resposta.Headers.Location);
Assert.Equal(20m, criado!.Total);
}
[Fact]
public async Task Post_SemItens_Retorna400ComProblemDetails()
{
var resposta = await _client.PostAsJsonAsync("/pedidos", new CreateOrderRequest("cliente-1", []));
Assert.Equal(HttpStatusCode.BadRequest, resposta.StatusCode);
var problema = await resposta.Content.ReadFromJsonAsync<ValidationProblemDetails>();
Assert.Contains("Items", problema!.Errors.Keys);
}
}
Autenticação nos testes
Em vez de gerar JWT de verdade, registre um esquema de autenticação de teste que aceita qualquer requisição com as claims que você definir. Assim o teste cobre a autorização (o 403 de quem não tem permissão) sem depender do provedor de identidade.
Banco limpo entre testes
Testes que escrevem precisam começar de um estado conhecido:
- Respawn: apaga os dados de todas as tabelas entre os testes, rápido e sem recriar o schema.
- Dados únicos por teste: cada teste usa ids próprios (
cliente-{Guid}), e nenhum depende do que o outro criou. É o que mais uso. - Transação revertida: funciona para repositório, mas não para a API, porque a requisição abre a própria conexão.
Por que não o provider InMemory
O UseInMemoryDatabase do EF Core não é um banco relacional: não tem transação de verdade, não valida chave estrangeira, não roda SQL. O teste passa e a produção quebra. A própria documentação da Microsoft desaconselha usá-lo para teste. Com Testcontainers, o banco do teste é o mesmo da produção.
No pipeline
Testcontainers precisa de Docker. Os runners do GitHub Actions com Ubuntu já têm; no Azure DevOps, use agentes Linux. Ver CI/CD.
O que perguntam em entrevista
- Como você testa uma API de ponta a ponta sem depender de ambiente compartilhado.
- Por que não usar banco em memória nos testes.
- Como você isola os dados entre testes.
- O que é o
WebApplicationFactory.