DI không tự động làm code của bạn test được. Một class inject bảy interface vẫn có thể không test được nếu bên trong nó gọi DateTime.Now, đọc static cache, hoặc resolve thêm service từ IServiceProvider. Khả năng kiểm thử là hệ quả của hình dạng phụ thuộc, không phải của việc dùng constructor injection.
Mục lục
Cập nhật 2026
- .NET 10 LTS (10.0.14);
WebApplicationFactory10.0.14 không còn bắt buộcpublic partial class Programcho top-level statements. Nếu tooling vẫn báo không tìm thấyProgram, thêmpublic partial class Program { }— vô hại. - xUnit v3 (4.0.2) chạy trên Microsoft.Testing.Platform; NSubstitute 6.2 là mặc định an toàn, Moq 4.21 vẫn dùng được (BSD-3 sau ồn ào SponsorLink).
TimeProvider+ góiMicrosoft.Extensions.TimeProvider.Testing10.11.0 (FakeTimeProvider) là cách chuẩn để kiểm soát thời gian, thay cho interfaceIClocktự chế.- FluentAssertions 8.11 chỉ miễn phí cho phiên bản phi thương mại (Xceed Community License); Shouldly 4.3 hoặc AwesomeAssertions là lựa chọn thay thế.
Constructor injection, không phải service locator
// SAI: phụ thuộc vô hình, không test được nếu không dựng cả container
public sealed class ReportService(IServiceProvider provider)
{
public Task<Report> BuildAsync(Guid id, CancellationToken ct) =>
provider.GetRequiredService<IReportBuilder>().BuildAsync(id, ct);
}
// ĐÚNG: phụ thuộc nằm trong chữ ký constructor
public sealed class ReportService(IReportBuilder builder)
{
public Task<Report> BuildAsync(Guid id, CancellationToken ct) =>
builder.BuildAsync(id, ct);
}
Service locator có ba hệ quả thực tế. Thứ nhất, bạn không thể test ReportService mà không dựng một ServiceProvider — tức test đơn vị biến thành test tích hợp. Thứ hai, dependency không hiện trong constructor nên ValidateOnBuild không thấy nó. Thứ ba, không ai đọc code biết ReportService cần gì để chạy.
Constructor cũng là thước đo thiết kế. Một class cần tám dependency thường không phải vấn đề DI mà là vấn đề chia trách nhiệm: nó đang làm quá nhiều thứ. Sửa ctor bằng cách tách class rẻ hơn nhiều so với dựng tám fake cho mỗi test.
Ngoại lệ hợp lý là nơi sở hữu vòng đời: BackgroundService giữ IServiceScopeFactory, middleware giữ IServiceScopeFactory, một factory pattern giữ IServiceProvider để tạo object theo runtime type. Những nơi đó tạo scope, không phải tìm dependency nghiệp vụ.
Interface ở ranh giới, không ở mọi nơi
Interface đáng giá khi nó đứng trước một ranh giới khó kiểm soát: mạng, database, hàng đợi, hệ thống file, đồng hồ, email, dịch vụ bên thứ ba. Ở đó interface cho phép thay implementation mà không chạm vào logic.
Interface không đáng giá khi nó chỉ bọc một lớp trong cùng process. IOrderMapper trỏ tới OrderMapper thuần tính toán là thêm một lớp trừu tượng, một file, và một dòng DI, để đổi lấy khả năng giả lập một thứ vốn đã nhanh và tất định. Với domain model, hãy test trực tiếp object thật.
Cùng logic đó áp dụng cho repository tổng quát. IRepository<T> với GetAll, Add, Update che mất ngữ nghĩa truy vấn của EF Core (projection, Include, AsNoTracking, phân trang) và buộc bạn mock một API mơ hồ. Thứ bạn thật sự cần kiểm thử là hành vi nghiệp vụ; một interface hẹp như IOrderReader với ba phương thức có nghĩa dễ fake hơn nhiều.
Test double: fake ở ranh giới, thật ở giữa
| Loại | Dùng khi | Ví dụ |
|---|---|---|
| Fake | Cần hành vi gần thật, rẻ hơn thật | InMemoryEmailSender ghi vào list |
| Stub | Cần một giá trị cố định để điều khiển luồng | IPaymentClient trả Declined |
| Mock | Tương tác chính là hành vi cần khẳng định | Phải gọi PublishAsync đúng một lần |
Lỗi phổ biến là mock mọi thứ và khẳng định từng lời gọi. Test như vậy khẳng định cách implement, không khẳng định kết quả: đổi cách gọi hai lần thành một lần gộp là test đỏ dù hành vi đúng. Quy tắc: ưu tiên khẳng định state sau khi chạy; chỉ Verify/Received khi bản thân việc gọi (hoặc không gọi) là yêu cầu nghiệp vụ — ví dụ “không gửi email khi thanh toán thất bại”.
Thời gian: TimeProvider, không phải DateTime.Now
// File: Domain/TrialPolicy.cs
public sealed class TrialPolicy(TimeProvider time)
{
public bool IsActive(Trial trial) =>
time.GetUtcNow() < trial.StartedAt.AddDays(14);
}
// Program.cs
builder.Services.AddSingleton(TimeProvider.System);
Test không cần ngủ, không cần chờ, và không phụ thuộc đồng hồ máy chủ:
[Fact]
public void Trial_expires_after_fourteen_days()
{
var clock = new FakeTimeProvider(DateTimeOffset.Parse("2026-11-07T00:00:00Z"));
var trial = new Trial(clock.GetUtcNow());
var policy = new TrialPolicy(clock);
Assert.True(policy.IsActive(trial));
clock.Advance(TimeSpan.FromDays(15));
Assert.False(policy.IsActive(trial));
}
Ba lợi ích: test chạy trong millisecond thay vì phải chờ, biên ngày/giờ được kiểm tra đúng, và logic hết hạn không còn phụ thuộc timezone của máy chạy CI. Cùng cách đó áp dụng cho token hết hạn, rate limit, retry backoff, và mọi thứ có DateTime.UtcNow.
Một chi tiết dễ sai: TimeProvider.GetUtcNow() trả DateTimeOffset, không phải DateTime. Đừng trộn hai kiểu trong domain; chọn một và viết extension nếu cần. Với FakeTimeProvider, thời gian chỉ nhảy khi bạn gọi Advance hoặc SetUtcNow — không có timer chạy ngầm, nên test không bao giờ flaky vì timing.
Tích hợp: WebApplicationFactory và thay service
// File: Tests/ApiFactory.cs
public sealed class ApiFactory : WebApplicationFactory<Program>
{
protected override void ConfigureWebHost(IWebHostBuilder builder)
{
builder.ConfigureTestServices(services =>
{
services.RemoveAll<IEmailSender>();
services.AddSingleton<IEmailSender, CapturingEmailSender>();
});
}
}
ConfigureTestServices chạy sau ConfigureServices của ứng dụng, nên descriptor bạn thêm là descriptor cuối và thắng khi resolve. RemoveAll<T>() đến từ Microsoft.Extensions.DependencyInjection.Extensions; nếu bạn chỉ AddSingleton mà không remove, container sẽ có hai descriptor và hành vi phụ thuộc thứ tự — đúng loại lỗi bạn đang cố tránh trong test.
Với database, đừng dùng provider InMemory: nó không có ràng buộc, không có transaction thật, và không có hành vi SQL. Dùng Testcontainers 4.16 dựng PostgreSQL/MySQL thật, Respawn 7 reset dữ liệu giữa các test:
builder.ConfigureTestServices(services =>
{
services.RemoveAll<AppDbContext>();
services.RemoveAll<DbContextOptions<AppDbContext>>();
services.AddDbContext<AppDbContext>(o => o.UseNpgsql(container.GetConnectionString()));
});
Phải remove cả AppDbContext lẫn DbContextOptions<AppDbContext>: nếu ứng dụng dùng AddDbContextPool, descriptor của context giữ factory riêng và chỉ remove options là không đủ.
IHttpClientFactory và handler giả
Không cần thay IHttpClientFactory. Chỉ cần thay HttpMessageHandler mà typed client dùng — đây là điểm cắt đúng, vì mọi thứ phía trên (base address, header, retry, serialization) vẫn chạy như thật.
public sealed class StubHandler(Func<HttpRequestMessage, HttpResponseMessage> respond)
: HttpMessageHandler
{
protected override Task<HttpResponseMessage> SendAsync(
HttpRequestMessage request, CancellationToken ct) =>
Task.FromResult(respond(request));
}
// Trong ConfigureTestServices
services.AddHttpClient<IPaymentClient, PaymentClient>(client =>
client.BaseAddress = new Uri("https://payments.test/"))
.ConfigurePrimaryHttpMessageHandler(() => new StubHandler(request =>
new HttpResponseMessage(HttpStatusCode.OK)
{
Content = JsonContent.Create(new { id = "ch_test_1", status = "succeeded" })
}));
Lợi ích so với mock IPaymentClient: bạn kiểm thử luôn cả tầng serialize/deserialize, đường dẫn URL, và cách xử lý status code — những thứ mà một mock interface bỏ qua hoàn toàn. Nếu handler cần kiểm tra body request, đọc request.Content trong delegate; nhớ rằng nội dung có thể chỉ đọc một lần.
IOptions trong test
var sut = new PaymentProcessor(
client,
Options.Create(new PaymentOptions { ApiKey = "test", TimeoutSeconds = 3 }));
Options.Create tạo một IOptions<T> bất biến — đúng thứ bạn cần cho unit test, không cần file cấu hình, không cần IConfiguration. Đây là lý do nên nhận IOptions<T> trong service thay vì IOptionsSnapshot<T> hay IConfiguration: hai thứ sau khó dựng trong test và kéo theo vòng đời scope. Nếu service thật sự cần đọc lại cấu hình, nhận IOptionsMonitor<T> và test bằng một implementation nhỏ tự viết.
IServiceProvider, IHost và scope trong test
Test tích hợp thường cần chạm vào container để kiểm tra trạng thái. Luôn tạo scope, đừng resolve scoped service từ factory.Services:
using var scope = factory.Services.CreateScope();
var db = scope.ServiceProvider.GetRequiredService<AppDbContext>();
var order = await db.Orders.SingleAsync(o => o.Id == orderId);
WebApplicationFactory chạy host ở môi trường Development theo mặc định, nên ValidateScopes và ValidateOnBuild đang bật: một captive dependency sẽ làm test khởi động đỏ ngay, không cần viết assertion nào. Đây là lý do rẻ nhất để có ít nhất một integration test, kể cả khi bạn chưa test gì khác.
Kiểm thử hosted service mà không chạy vòng lặp
BackgroundService.ExecuteAsync là vòng lặp vô hạn có Task.Delay — test trực tiếp nó sẽ phải chờ, và chờ là flaky. Cách đúng là thiết kế đơn vị công việc thành một method nhận dependency từ scope, rồi test method đó:
[Fact]
public async Task PublishBatch_marks_rows_as_sent()
{
await using var factory = new ApiFactory();
using var scope = factory.Services.CreateScope();
var db = scope.ServiceProvider.GetRequiredService<AppDbContext>();
var publisher = scope.ServiceProvider.GetRequiredService<IOutboxPublisher>();
db.Outbox.Add(new OutboxMessage { Payload = "{}" });
await db.SaveChangesAsync();
await publisher.PublishBatchAsync(db, CancellationToken.None);
Assert.All(db.Outbox.Local, m => Assert.NotNull(m.SentAt));
}
Điều này cũng buộc bạn tách vòng lặp (while + Task.Delay) khỏi logic xử lý — một cấu trúc tốt hơn cho cả production. Nếu bạn thật sự cần test việc host khởi động service, hãy dùng factory.Services.GetServices<IHostedService>() và gọi StartAsync/StopAsync với timeout tường minh, chứ đừng chờ vòng lặp tự kết thúc.
InternalsVisibleTo: mở vừa đủ
<!-- File: src/MyApp/MyApp.csproj -->
<ItemGroup>
<InternalsVisibleTo Include="MyApp.Tests" />
</ItemGroup>
Dùng khi bạn muốn giữ type là internal nhưng vẫn test trực tiếp — handler nội bộ, validator, một hàm thuần tính toán. Hai lưu ý: nếu assembly được ký tên mạnh, phải thêm PublicKey; và đừng dùng nó để test private method qua reflection, vì test như vậy khoá implementation và vỡ ở mọi lần refactor hợp lệ.
Bốn thứ làm test chậm và flaky
- Over-mocking. Mock cả domain object, mock
ILogger, mock mapper. Mỗi mock là một giả định về implementation; 20 mock là 20 giả định phải cập nhật khi refactor. Thread.Sleep/Task.Delaytrong test. Nếu logic cần thời gian, đưaTimeProvidervào. Nếu test cần chờ I/O, dùngawaitvà timeout của framework.- State tĩnh dùng chung.
staticfield hoặc singleton cache giữ dữ liệu giữa các test làm chúng phụ thuộc thứ tự chạy. xUnit chạy song song theo collection — đây là nguồn flaky số một. - Provider InMemory thay cho database thật. Test xanh, production đỏ vì ràng buộc unique, khoá ngoại, collation và transaction không được mô phỏng.
Chọn loại test nào
| Mục tiêu | Công cụ | Chi phí |
|---|---|---|
| Logic nghiệp vụ, tính toán, policy | xUnit v3 + NSubstitute, không container | Millisecond |
| Endpoint + DI + serialization + DB | WebApplicationFactory + Testcontainers + Respawn |
Vài giây mỗi test class |
| Luồng người dùng thật | Playwright 1.64 | Chục giây, chạy trên pipeline |
Tỉ lệ lành mạnh: nhiều test mức một, một ít test tích hợp cho mỗi endpoint quan trọng, vài luồng E2E cho hành trình doanh thu. Đừng cố đạt 100% coverage ở tầng đơn vị bằng cách mock mọi thứ — đó là coverage của mock, không phải của nghiệp vụ.
2027
.NET 11 GA tháng 11/2026 (STS); MTP và xUnit v3 là hướng chạy test mặc định, dotnet test hợp nhất hơn. AI-assisted test generation đã phổ biến để sinh case biên, nhưng giá trị thật vẫn nằm ở việc thiết kế ranh giới đúng — thứ không công cụ nào làm hộ bạn.
Checklist
- Domain không gọi
DateTime.Now,Guid.NewGuidrải rác, hayIServiceProvider. - Interface chỉ ở ranh giới I/O; domain test bằng object thật.
- Có một
WebApplicationFactorychạy ở Development để bắt captive dependency. - Database test là container thật, không phải provider InMemory.
- HttpClient test bằng handler giả, không mock typed client.
- Không
Thread.Sleep; thời gian đến từTimeProvider.
Đọc tiếp: Vòng đời dịch vụ trong DI, Cấu hình DI với Scrutor, Kiểm thử tích hợp với WebApplicationFactory, và Mocking với Moq và NSubstitute.



