Tạo Dữ Liệu Giả với AutoFixture và Bogus: Công Cụ Hữu Ích trong Lộ Trình .NET

new User { Id = 1, Name = "Test", Email = "test@test.com" } xuất hiện ở 40 chỗ trong bộ test là một mùi code. Nó không chỉ lặp; nó làm test pass vì dữ liệu thuận tiện chứ không phải vì sản phẩm đúng. AutoFixture và Bogus giải quyết hai vấn đề khác nhau, và dùng lẫn lộn hai thứ này là nguồn gốc của phần lớn test “ngẫu nhiên mà vẫn sai”.

Cập nhật 2026

  • AutoFixture 4.18.1 và Bogus 35.6.5 là bản hiện tại; cả hai đều là thư viện MIT/Apache-friendly, không có vấn đề giấy phép như FluentAssertions 8.
  • Tích hợp xUnit chính thức là AutoFixture.Xunit2, dùng với xunit 2.9.3. Đừng trộn với xunit.v3 — hai dòng package khác nhau.
  • Bogus hỗ trợ locale “vi”, nhưng dữ liệu tiếng Việt vẫn là dữ liệu giả người thật: phải xử lý như PII trong mọi môi trường ngoài local.
  • .NET 8/9 hết hỗ trợ 2026-11-10; test project cũng phải lên .NET 10 như project sản phẩm.

Hai triết lý khác nhau

AutoFixture trả lời câu hỏi: “cho tôi một instance hợp lệ của kiểu này, tôi không quan tâm giá trị cụ thể”. Nó duyệt constructor và property, đệ quy vào object graph, điền mọi thứ có thể. Chuỗi mặc định là GUID, số là ngẫu nhiên, collection có vài phần tử. Mục tiêu là đủ hợp lệ để chạy.

Bogus trả lời câu hỏi: “cho tôi dữ liệu trông như thật”. Nó có bộ sinh theo ngữ cảnh — tên người, địa chỉ, số điện thoại, công ty, ngày tháng — theo locale. Mục tiêu là đọc được và có ngữ nghĩa: dùng cho seed database, demo, screenshot, dữ liệu màn hình.

Nhầm lẫn phổ biến: dùng Bogus trong unit test để “cho thật”, rồi phụ thuộc vào giá trị sinh ra. Ngược lại, dùng AutoFixture để seed database dev, rồi database toàn GUID và số vô nghĩa. Chọn theo mục đích, không theo độ phổ biến.

AutoFixture: từ Create đến Build

// File: Tests/Infrastructure/FixtureFactory.cs
using AutoFixture;

public static class FixtureFactory
{
    public static Fixture Create()
    {
        var fixture = new Fixture();

        fixture.Customize<Customer>(c => c
            .With(x => x.Country, "VN")
            .Without(x => x.Id));

        return fixture;
    }
}

Without(x => x.Id) đặt Id về default — với int là 0, với Guid là Guid.Empty. Đó là hành vi đúng cho entity chờ database sinh khóa, nhưng đừng nhầm với “không gán”: giá trị vẫn tồn tại, chỉ là giá trị mặc định.

Build<T>() dùng khi chỉ một vài instance cần giá trị cụ thể. Nó rẻ hơn Customize vì không ảnh hưởng các lần Create sau:

var order = fixture.Build<Order>()
    .With(o => o.Currency, "VND")
    .With(o => o.Total, 250_000m)
    .Without(o => o.Id)
    .Create();

Với collection, fixture.CreateMany<Order>(3) sinh ba instance; fixture.CreateMany<Order>(3).ToList() nếu bạn cần List<T>. Đừng dùng fixture.Create<List<Order>>() rồi giả định số phần tử — số lượng do RepeatCount quyết định và có thể đổi giữa các phiên bản.

[AutoData]: ít code, nhưng dễ sinh test vô nghĩa

AutoFixture.Xunit2 cung cấp [AutoData] để inject tham số đã được sinh. Với test logic thuần, nó giảm đáng kể boilerplate:

using AutoFixture.Xunit2;
using Xunit;

public sealed class DiscountTests
{
    [Theory, AutoData]
    public void Apply_ReturnsReducedTotal(decimal total, int percent)
    {
        var result = Discount.Apply(total, percent);
        Assert.True(result <= total);
    }
}

Nhưng [AutoData] chỉ đảm bảo hợp lệ theo kiểu, không hợp lệ theo miền nghiệp vụ. percent ở trên có thể là int.MinValue hoặc 4 tỷ; total có thể âm. Test sẽ fail vì dữ liệu, không vì logic. Đây là lý do nhiều team cấm [AutoData] sau vài tuần.

Cách sửa rẻ nhất: dùng [InlineAutoData] cho tham số quan trọng, để phần còn lại vẫn được sinh:

[Theory]
[InlineAutoData(0)]
[InlineAutoData(10)]
[InlineAutoData(100)]
public void Apply_AtBoundaries(int percent, decimal total)
{
    var result = Discount.Apply(total, percent);
    Assert.True(result <= total);
}

Cách bền hơn: viết một ICustomization cho miền nghiệp vụ và một attribute riêng. Nhưng chỉ làm khi bạn có từ ba loại giá trị ràng buộc trở lên; với một vài test, [InlineAutoData] là đủ và dễ đọc hơn.

Bogus: Faker<T> và locale “vi”

// File: Tests/Infrastructure/CustomerFaker.cs
using Bogus;

public static class CustomerFaker
{
    public static Faker<Customer> Create(string locale = "vi") =>
        new Faker<Customer>(locale)
            .RuleFor(c => c.Id, _ => Guid.NewGuid())
            .RuleFor(c => c.FullName, f => f.Name.FullName())
            .RuleFor(c => c.Email, f => $"customer-{f.Random.Guid():N}@example.com")
            .RuleFor(c => c.Phone, f => f.Phone.PhoneNumber("0#########"))
            .RuleFor(c => c.City, f => f.Address.City())
            .RuleFor(c => c.CreatedAt, f => f.Date.Past(2, DateTime.UtcNow));
}

Ba chi tiết đáng chú ý. Email dùng GUID và domain example.com — domain dành riêng cho ví dụ, không bao giờ gửi được thật. Số điện thoại dùng format cố định thay vì số ngẫu nhiên, để không vô tình trùng số thật. Và locale "vi" đặt trên Faker<T>, không phải trên từng lời gọi f.Name.FirstName("vi") — API sau không tồn tại, đây là lỗi phổ biến trong các bài viết cũ.

Với dữ liệu phẳng, new Faker("vi").Name.FullName() cũng đủ. Faker<T> chỉ cần khi bạn muốn RuleFor và Generate(n).

Đừng giữ một Faker<T> static dùng chung. Nó giữ Randomizer nội bộ; chia sẻ giữa các test chạy song song làm dữ liệu phụ thuộc thứ tự, và các rule có state (index, ngày tham chiếu) có thể nhảy giữa các lần gọi. Khởi tạo faker trong mỗi test hoặc qua factory method như trên — chi phí này không đáng kể so với I/O của test.

Cũng đừng Generate(10_000) trong một unit test. Số lượng lớn thuộc về script seed database, nơi chạy một lần và có thể mất vài giây; trong test, nó biến một assertion đơn giản thành bài đo hiệu năng không ai yêu cầu.

Deterministic: seed có, nhưng không miễn phí

Bogus cho phép seed để tái lập dữ liệu:

Randomizer.Seed = new Random(20261107);
var customers = CustomerFaker.Create().Generate(20);

Randomizer.Seed là static toàn cục. Trong xUnit chạy song song, hai test cùng đọc/ghi seed sẽ cho kết quả phụ thuộc thứ tự chạy — tức là bạn vừa đổi flakiness lấy tính “tái lập” trên giấy. Nếu cần dữ liệu ổn định, đừng seed: dùng builder với giá trị viết tay. Seed chỉ hợp lý cho script seed database dev, nơi chạy một lần và không song song.

Một lưu ý nữa: Faker<T>.Generate(n) sinh tuần tự theo một randomizer, nên thêm một rule mới ở giữa sẽ làm lệch toàn bộ dữ liệu phía sau. Đó là lý do seed không thay thế được test có assertion rõ ràng.

Dữ liệu thật vs dữ liệu hợp lệ

Nhu cầu Công cụ Ví dụ
Instance hợp lệ để chạy logic AutoFixture Test tính giá, mapping, validation
Dữ liệu đọc được trên màn hình Bogus Seed dev, demo, screenshot
Giá trị biên có ý nghĩa Viết tay [InlineData], builder
Cấu trúc object lồng nhau AutoFixture Aggregate nhiều tầng

Không có công cụ nào sinh được “trường hợp biên”. Máy không biết với nghiệp vụ của bạn, 0, -1, int.MaxValue hay một chuỗi 10.000 ký tự mới là biên. Biên phải do người viết test khai báo.

Biên và input không hợp lệ

[Theory]
[InlineData("")]
[InlineData("   ")]
[InlineData("khong-phai-email")]
[InlineData("an@example.com\r\nBcc: attacker@example.com")]
[InlineData("an@example.com ")]
public void ValidateEmail_RejectsMalformedInput(string input)
{
    var result = EmailValidator.Validate(input);
    Assert.False(result.IsValid);
}

Đây là những case mà AutoFixture không bao giờ sinh ra: chuỗi rỗng, khoảng trắng, newline, ký tự điều khiển, Unicode tổ hợp, emoji, chuỗi dài hơn cột database. Một bộ test chỉ dùng dữ liệu sinh tự động thường bỏ qua toàn bộ nhóm này, và đó là nhóm bug thật.

Với input hợp lệ nhưng khó, hãy thử: dấu tiếng Việt ở các bảng mã khác nhau, tên có một ký tự, địa chỉ không có số nhà, số điện thoại có mã quốc gia. Bogus với locale "vi" cho bạn dữ liệu đa dạng để thử UI, nhưng vẫn không thay thế được danh sách biên do bạn kiểm soát.

PII: dữ liệu giả vẫn là dữ liệu

  • Không seed production. Một script seed chạy nhầm môi trường là sự cố dữ liệu, không phải sự cố test.
  • Dùng domain dành riêng. example.com và TLD .test được dành riêng cho kiểm thử; đừng dùng domain thật dù chỉ để hiển thị.
  • Số điện thoại, CCCD, địa chỉ: Bogus sinh theo format thật, có thể trùng người thật. Với dữ liệu nhạy cảm, dùng giá trị rõ ràng là giả (chuỗi TEST-...) thay vì số ngẫu nhiên trông thật.
  • Không commit file seed đã sinh. Nếu cần chia sẻ, commit script sinh, không commit output.
  • Screenshot và tài liệu cũng là nơi dữ liệu giả bị coi là thật. Ghi rõ “dữ liệu tổng hợp” khi đưa vào tài liệu nội bộ.

Test data builder: khi nào đáng viết

Builder hữu ích khi một object có nhiều trường nhưng mỗi test chỉ quan tâm một trường. Nó biến “20 dòng khởi tạo” thành một dòng có ý nghĩa, và khi model thêm trường, chỉ builder phải sửa.

// File: Tests/Builders/CustomerBuilder.cs
public sealed class CustomerBuilder
{
    private string _email = "buyer@example.com";
    private decimal _creditLimit = 5_000_000m;

    public CustomerBuilder WithEmail(string email)
    {
        _email = email;
        return this;
    }

    public CustomerBuilder WithCreditLimit(decimal limit)
    {
        _creditLimit = limit;
        return this;
    }

    public Customer Build() => new()
    {
        Id = Guid.NewGuid(),
        Email = _email,
        CreditLimit = _creditLimit,
        CreatedAt = new DateTime(2026, 1, 1, 0, 0, 0, DateTimeKind.Utc)
    };
}

Builder và AutoFixture không loại trừ nhau. Builder cho phần có nghĩa nghiệp vụ; AutoFixture cho phần không ai quan tâm (navigation property, audit field, collection con). Cách kết hợp gọn: builder nhận một Fixture trong constructor và dùng fixture.Create<Address>() cho trường phụ.

Đừng xây framework dữ liệu test

Đã thấy nhiều dự án có TestDataFactory<T> với reflection, options, provider và convention riêng. Nó là một framework không có người dùng thứ hai, khó debug hơn dữ liệu viết tay, và thường sinh ra dữ liệu không ai hiểu. Giới hạn hợp lý: 3–5 builder cho aggregate quan trọng, một FixtureFactory cấu hình sẵn, một CustomerFaker cho seed. Hết.

Nếu một test cần đúng một giá trị cụ thể để chứng minh bug, viết giá trị đó ra. Tính biểu cảm của new Customer { CreditLimit = 0 } cao hơn nhiều so với fixture.Create<Customer>() mà người đọc phải đi tìm giá trị thực tế trong log.

Nhìn sang 2027

.NET 11 dự kiến GA trong tháng 11/2026 (STS), .NET 10 LTS vẫn là nền production. Với dữ liệu test, hướng đang đi là sinh dữ liệu tổng hợp có kiểm soát thay vì ngẫu nhiên hoàn toàn — đặc biệt khi test chạy trong pipeline có yêu cầu tuân thủ dữ liệu. AI có thể đề xuất bộ biên, nhưng vẫn cần người xác nhận biên nào là quan trọng với nghiệp vụ.

Checklist

  • Pin AutoFixture 4.18.1, AutoFixture.Xunit2, Bogus 35.6.5; dùng với xUnit 2.9.3.
  • AutoFixture cho cấu trúc, Bogus cho dữ liệu hiển thị, viết tay cho biên.
  • Không dùng [AutoData] cho tham số có ràng buộc nghiệp vụ; dùng [InlineAutoData].
  • Email luôn dùng example.com; không seed production; không commit dữ liệu sinh.
  • Không seed toàn cục trong test song song; ưu tiên builder có giá trị cố định.
  • Giữ số builder ở mức 3–5; không xây framework dữ liệu test.

Dữ liệu test chỉ có giá trị khi tầng kiểm thử bên dưới đúng. Đọc Kiểm thử tích hợp với WebApplicationFactory để biết cách seed vào database thật, và Mocking với Moq và NSubstitute cho phần cô lập dependency. Nếu bạn đang làm BDD, xem BDD với Reqnroll; còn E2E với Playwright là nơi dữ liệu “trông thật” thực sự có ích.