Lộ Trình .NET: Phát triển Hướng Hành Vi (BDD) với Reqnroll – Kế Tiếp SpecFlow

BDD không phải là một framework kiểm thử. Nó là một cách viết yêu cầu: ba bên — người hiểu nghiệp vụ, người kiểm thử, người viết code — thống nhất về hành vi bằng những ví dụ cụ thể trước khi code. Nếu bạn chỉ dùng Gherkin để thay cho tên test method, bạn đã lấy công cụ mà bỏ mất phần giá trị nhất.

Cập nhật 2026

  • SpecFlow đã ngừng phát triển. Tricentis rút hỗ trợ, repository bị archive; các gói SpecFlow* trên NuGet vẫn tải được nhưng không còn bản vá. Đừng bắt đầu dự án mới với nó.
  • Reqnroll 3.3.4 là successor được duy trì, cùng cú pháp Gherkin, cùng attribute [Binding]/[Given], chỉ đổi namespace từ TechTalk.SpecFlow sang Reqnroll.
  • Project test dùng xUnit 2.9.3 hoặc NUnit/MSTest tương ứng; dotnet test trên .NET 10 chạy qua Microsoft.Testing.Platform khi project được cấu hình MTP.
  • FluentAssertions 8.11 không còn miễn phí cho thương mại (Xceed Community License). Ví dụ trong bài dùng Shouldly 4.3.0 (BSD).

Ba hoạt động của BDD, không chỉ là automation

Mô hình gốc có ba phần, và phần thứ ba chỉ là phần dễ thấy nhất:

  • Discovery — cùng nhau tìm ra ví dụ nào thực sự mô tả hành vi, và ví dụ nào là biên. Đầu ra là danh sách tình huống, không phải file.
  • Formulation — viết những ví dụ đó bằng Gherkin, theo góc nhìn người dùng, không theo góc nhìn bảng hay API.
  • Automation — nối các câu đó với code bằng step definition.

Nếu bỏ hai phần đầu, bạn còn lại một tầng chuyển đổi đắt tiền: mỗi test phải viết hai lần, một lần bằng tiếng Việt và một lần bằng C#, trong khi không ai ngoài developer đọc file feature. Đây là lý do phổ biến nhất khiến BDD bị bỏ sau sáu tháng.

Gherkin: viết hành vi, không viết thao tác UI

Giữ keyword tiếng Anh (Feature, Scenario, Given, When, Then) và nội dung tiếng Việt. Cách này tránh phải nhớ bộ keyword bản địa hóa và vẫn đọc được với người nghiệp vụ. Mỗi file mô tả một feature, mỗi scenario là một ví dụ có thể kiểm chứng độc lập.

# File: Features/Checkout.feature
Feature: Đặt hàng
  Là khách hàng đã đăng nhập
  Tôi muốn đặt hàng từ giỏ hàng
  Để nhận được xác nhận đơn hàng

  Background:
    Given cửa hàng còn 10 sản phẩm "SKU-1"

  Scenario: Đặt hàng khi còn tồn kho
    Given khách hàng "an@example.com" đã đăng nhập
    And giỏ hàng có 2 sản phẩm "SKU-1"
    When khách hàng xác nhận đặt hàng
    Then đơn hàng được tạo với trạng thái "Pending"
    And tồn kho của "SKU-1" còn 8

  Scenario: Không đặt được khi hết hàng
    Given khách hàng "an@example.com" đã đăng nhập
    And giỏ hàng có 2 sản phẩm "SKU-1"
    And cửa hàng còn 0 sản phẩm "SKU-1"
    When khách hàng xác nhận đặt hàng
    Then hệ thống báo "Sản phẩm đã hết hàng"

  Scenario Outline: Đặt nhiều số lượng khác nhau
    Given khách hàng "an@example.com" đã đăng nhập
    And giỏ hàng có <quantity> sản phẩm "SKU-1"
    When khách hàng xác nhận đặt hàng
    Then đơn hàng có tổng tiền <total>

    Examples:
      | quantity | total  |
      | 1        | 250000 |
      | 3        | 750000 |

Hai điều đáng chú ý trong ví dụ trên. Step mô tả ý định nghiệp vụ (“xác nhận đặt hàng”), không mô tả cú click hay tên nút — nhờ vậy đổi UI không làm vỡ kịch bản. Và Background chỉ chứa điều kiện chung cho mọi scenario; nếu nó bắt đầu chứa hành động, đó là dấu hiệu kịch bản đang bị nhồi.

Đừng dùng Gherkin cho mọi thứ. Một quy tắc đơn giản: nếu chỉ developer quan tâm và không có biên nghiệp vụ nào cần thống nhất, viết unit test bình thường. BDD sống ở tầng tính năng, nơi có người ngoài kỹ thuật cùng đọc.

Cài đặt Reqnroll

dotnet new classlib -n Shop.BddTests -f net10.0
cd Shop.BddTests

dotnet add package Reqnroll.xUnit --version 3.3.4
dotnet add package xunit --version 2.9.3
dotnet add package Microsoft.NET.Test.Sdk
dotnet add package Shouldly --version 4.3.0

Reqnroll.xUnit kéo theo package lõi Reqnroll và generator MSBuild — thứ biến mỗi file .feature thành một lớp test trong lúc build. Nếu generator không được tham chiếu tự động, thêm Reqnroll.Tools.MsBuild.Generation cùng version 3.3.4. Sau khi build, scenario xuất hiện trong Test Explorer với tên lấy từ file feature; chúng sẽ fail với thông báo thiếu step definition cho tới khi bạn viết đủ các bước.

Với NUnit hoặc MSTest, đổi gói thành Reqnroll.NUnit / Reqnroll.MSTest. Không trộn nhiều runner trong cùng một project test.

Step definitions: cầu nối, không phải nơi chứa logic

Mỗi step definition nên mỏng: chuyển tham số, gọi một API hoặc service, lưu kết quả vào context. Logic nghiệp vụ thuộc về application, không thuộc về file test. Nếu một step definition dài quá 15 dòng, thường là bạn đang kiểm thử sai tầng.

// File: StepDefinitions/CheckoutSteps.cs
using Reqnroll;
using Shouldly;

[Binding]
public sealed class CheckoutSteps(ShopApi api, ScenarioContext scenario)
{
    [Given(@"cửa hàng còn (\d+) sản phẩm ""(.*)""")]
    public Task GivenTonKho(int quantity, string sku) =>
        api.SetStockAsync(sku, quantity);

    [Given(@"khách hàng ""(.*)"" đã đăng nhập")]
    public Task GivenDaDangNhap(string email) =>
        api.SignInAsync(email);

    [Given(@"giỏ hàng có (\d+) sản phẩm ""(.*)""")]
    public async Task GivenGioHang(int quantity, string sku)
    {
        var cartId = await api.AddToCartAsync(sku, quantity);
        scenario["cartId"] = cartId;
    }

    [When(@"khách hàng xác nhận đặt hàng")]
    public async Task WhenXacNhan()
    {
        var cartId = scenario.Get<Guid>("cartId");
        scenario["response"] = await api.CheckoutAsync(cartId);
    }

    [Then(@"đơn hàng được tạo với trạng thái ""(.*)""")]
    public void ThenTrangThai(string expected)
    {
        var response = scenario.Get<CheckoutResponse>("response");
        response.Status.ShouldBe(expected);
        response.OrderId.ShouldNotBe(Guid.Empty);
    }
}

Regex (.*) và (\d+) là cú pháp mặc định của Reqnroll. Đặt tên method theo tiếng Việt không dấu là lựa chọn của đội; điều quan trọng là mỗi mẫu step chỉ tồn tại một lần. Nếu hai step definition cùng khớp một dòng, Reqnroll báo lỗi ambiguous binding ngay khi chạy — hãy sửa bằng cách làm mẫu cụ thể hơn, không bằng cách đổi tên kịch bản.

ShopApi và TestDatabase trong ví dụ là hai lớp mỏng của bạn; chúng cần được đăng ký trong container, hoặc thay bằng client tạo trong hook. Phần DI bên dưới cho thấy cách đăng ký bằng IServiceCollection.

ScenarioContext và FeatureContext

ScenarioContext là state của một scenario, được tạo mới cho mỗi lần chạy. Đây là nơi đúng để truyền dữ liệu giữa các step: scenario["cartId"] = cartId rồi scenario.Get<Guid>("cartId"). FeatureContext sống theo feature và phù hợp cho thứ chỉ đọc như cấu hình, đường dẫn file, connection string.

Sai lầm hay gặp là dùng field static để chia sẻ state “cho nhanh”. Nó sống qua các scenario và qua cả các lần chạy song song, nên test đúng hôm nay có thể fail ở lần chạy CI thứ ba. Nếu state không thuộc về một scenario, nó nên nằm trong một service được DI quản lý, không nằm trong biến static.

Hooks: setup rẻ, teardown chắc

// File: StepDefinitions/Hooks.cs
using Reqnroll;
using Xunit.Abstractions;

[Binding]
public sealed class Hooks(TestDatabase db, ScenarioContext scenario, ITestOutputHelper output)
{
    [BeforeScenario]
    public Task ResetDatabase() => db.ResetAsync();

    [AfterScenario]
    public void ReportFailure()
    {
        if (scenario.TestError is not null)
        {
            output.WriteLine($"Scenario failed: {scenario.ScenarioInfo.Title}");
            output.WriteLine(scenario.TestError.ToString());
        }
    }
}

Hai lưu ý về hook. [BeforeFeature]/[AfterFeature] phải là method static và nhận FeatureContext, nên chúng không inject được ITestOutputHelper; hãy để chúng cho việc thật sự cần ở cấp feature. [BeforeScenario] là instance method và có thể async. Và đừng đặt việc nặng trong [BeforeScenario] nếu nó không cần thiết cho từng kịch bản — 200 scenario nghĩa là 200 lần dựng dữ liệu, đó là nơi thời gian test bị ăn hết.

Tích hợp DI: container mặc định và Microsoft DI

Reqnroll có container nội bộ (dựa trên BoDi) và tự inject dependency vào constructor của step class và hook. Đó là lý do ShopApi, ScenarioContext, TestDatabase xuất hiện trong constructor ở trên mà không cần đăng ký gì.

Nếu ứng dụng đã dùng IServiceCollection và bạn muốn dùng đúng cấu hình DI đó trong test, cài plugin Reqnroll.Microsoft.Extensions.DependencyInjection và khai báo một method static trả về IServiceCollection:

// File: StepDefinitions/ScenarioDependencies.cs
using Microsoft.Extensions.DependencyInjection;
using Reqnroll;

[Binding]
public static class ScenarioDependencies
{
    [ScenarioDependencies]
    public static IServiceCollection CreateServices()
    {
        var services = new ServiceCollection();
        services.AddSingleton<IClock>(new FixedClock(new DateTime(2026, 11, 7)));
        services.AddScoped<TestDatabase>();
        services.AddScoped<ShopApi>();
        return services;
    }
}

Plugin tạo một ServiceProvider mới cho mỗi scenario, nên Scoped ở đây thực sự là scenario-scoped — đúng ngữ nghĩa bạn cần cho DbContext và HTTP client của test. Đừng đăng ký Singleton cho thứ giữ state giữa các scenario; nó sẽ phá tính độc lập mà bạn vừa dựng công.

Dữ liệu test trong BDD

Giá trị trong file feature phải là giá trị có nghĩa với nghiệp vụ và nhìn thấy được: 2 sản phẩm, 250000, "Sản phẩm đã hết hàng". Đừng sinh ngẫu nhiên trong step definition. Nếu cần nhiều bộ dữ liệu, dùng Scenario Outline + Examples để biến thể hiện rõ trên file; nếu cần dữ liệu nền phức tạp, dùng builder hoặc Bogus trong hook. Nguyên tắc: người đọc file feature phải trả lời được “kịch bản này kiểm tra cái gì” mà không mở code C#.

Pitfall: năm cách làm BDD thất bại

  • Step dính vào UI. “When tôi click vào nút màu xanh ở góc phải” là test script trá hình. Đổi thành “When khách hàng xác nhận đặt hàng”.
  • Quá nhiều scenario. Mỗi tổ hợp tham số thành một scenario là bùng nổ tổ hợp. Dùng Scenario Outline cho biến thể dữ liệu, và chỉ giữ scenario cho hành vi khác nhau thật sự.
  • Developer viết một mình. File feature không có người nghiệp vụ đọc thì không còn là BDD, chỉ là test có cú pháp dài hơn.
  • Step definition trùng lặp. Nhiều mẫu regex khớp cùng một câu, hoặc mỗi feature có bản step riêng. Gom step dùng chung vào một lớp theo miền nghiệp vụ.
  • Kịch bản phụ thuộc thứ tự. Dùng state static, database không reset, hoặc scenario B giả định scenario A vừa chạy. Mỗi scenario phải chạy được một mình.

Khi nào BDD đáng công

Bối cảnh Nên dùng BDD Không nên
Có người nghiệp vụ tham gia Có, đây là điều kiện chính Không, chỉ còn developer đọc
Miền nghiệp vụ phức tạp, nhiều biên Rất phù hợp CRUD đơn giản
UI thay đổi liên tục Chỉ khi step ở tầng hành vi Step mô tả chi tiết UI
Vòng đời sản phẩm dài Có, tài liệu sống có giá trị Prototype vài tuần

Một tín hiệu tốt: sau ba tháng, file feature vẫn được cập nhật trước khi code đổi. Một tín hiệu xấu: file feature chỉ được sửa khi test fail.

Living documentation, ở mức thực dụng

Đừng kỳ vọng một công cụ biến file feature thành tài liệu đẹp tự động. Living documentation nghĩa là: file .feature nằm trong repo, được review như tài liệu, chạy trong CI, và trạng thái pass/fail của từng scenario được publish kèm tên feature. Reqnroll có formatter để xuất kết quả (HTML, JSON) cấu hình trong reqnroll.json; nhưng giá trị nằm ở việc team thực sự đọc file, không nằm ở báo cáo.

Nếu bạn dùng Azure DevOps hoặc GitHub Actions, hãy để artifact của mỗi lần chạy chứa cả file feature và kết quả scenario. Khi một kịch bản fail, người đọc thấy ngay câu nghiệp vụ nào sai, thay vì phải giải mã tên test.

Nhìn sang 2027

.NET 11 dự kiến GA trong tháng 11/2026 và là bản STS; .NET 10 LTS vẫn là nền production. Với BDD, thay đổi đáng theo dõi là AI hỗ trợ soạn Gherkin từ mô tả nghiệp vụ — hữu ích để tạo bản nháp, nhưng scenario vẫn phải do người hiểu nghiệp vụ duyệt, nếu không bạn chỉ tự động hóa việc hiểu sai yêu cầu nhanh hơn.

Checklist

  • Xác định rõ ai đọc file feature; nếu chỉ có developer, cân nhắc dừng lại.
  • Cài Reqnroll.xUnit 3.3.4, bỏ mọi reference SpecFlow* cũ.
  • Viết 3–5 scenario cho một feature quan trọng nhất trước, không viết hàng loạt.
  • Step mô tả hành vi nghiệp vụ; logic nằm trong service, không trong step.
  • Reset database trong [BeforeScenario], không dùng state static.
  • Chạy dotnet test trong CI và publish kết quả scenario.

Nếu bạn chưa dựng tầng kiểm thử tích hợp bên dưới, đọc Kiểm thử tích hợp với WebApplicationFactory trước — step definition thường gọi vào đúng API đó. Bài E2E với Playwright dành cho luồng qua trình duyệt, còn chọn framework unit test giúp bạn quyết định runner nào đứng sau Reqnroll. Dữ liệu cho các step nền có thể lấy từ AutoFixture và Bogus.