Gherkin 是一种用于描述软件行为的简单、结构化的领域特定语言，常用于行为驱动开发（BDD）。在 .NET 微服务项目中，使用 Gherkin 可以清晰地定义服务接口的行为，帮助开发、测试和业务人员达成一致。它通过 Given、When、Then 等关键字描述场景，通常配合 SpecFlow 框架在 .NET 环境中实现自动化测试。
编写 Gherkin 场景的基本结构
Gherkin 文件以 .feature 为扩展名，每个文件描述一个功能或 API 行为。基本结构包括功能描述和多个具体场景。
示例：用户查询订单状态的微服务行为
Feature: 订单查询服务 作为用户 我希望查询订单状态 以便了解订单处理进度 <p>Scenario: 成功查询存在的订单 Given 系统中存在订单 ID 为 "ORD123" 的订单 When 用户请求获取订单 "ORD123" 的信息 Then 应返回状态码 200 And 响应包含订单状态 "已发货"</p><p>Scenario: 查询不存在的订单 Given 系统中不存在订单 ID 为 "ORD999" 的订单 When 用户请求获取订单 "ORD999" 的信息 Then 应返回状态码 404</p>
映射 Gherkin 步骤到 .NET 测试代码
在 .NET 中，使用 SpecFlow 将 Gherkin 步骤绑定到 C# 方法。SpecFlow 会自动匹配文本与带 [Given]、[When]、[Then] 特性的方法。
示例：SpecFlow 步骤定义类
[Binding]
public class OrderStepDefinitions
{
private readonly HttpClient _client = new();
private HttpResponseMessage _response;
private string _orderId;
<pre class='brush:php;toolbar:false;'>[Given(@"系统中存在订单 ID 为 ""(.*)"" 的订单")]
public async Task GivenOrderExists(string orderId)
{
// 可调用种子数据 API 或直接写入测试数据库
await SeedOrderToDatabase(orderId, "已发货");
_orderId = orderId;
}
[When(@"用户请求获取订单 ""(.*)"" 的信息")]
public async Task WhenUserRequestsOrderInfo(string orderId)
{
_response = await _client.GetAsync($"https://localhost:5001/api/orders/{orderId}");
}
[Then(@"应返回状态码 (.*)")]
public void ThenStatusCodeShouldBe(int expectedCode)
{
_response.StatusCode.Should().Be((HttpStatusCode)expectedCode);
}
[Then(@"响应包含订单状态 ""(.*)""")]
public async Task ThenResponseContainsStatus(string expectedStatus)
{
var content = await _response.Content.ReadAsStringAsync();
content.Should().Contain($"\"status\":\"{expectedStatus}\"");
}}
集成到微服务自动化测试流程
将 Gherkin 场景作为微服务的契约测试或集成测试运行，确保 API 行为符合预期。
使用 TestServer（如 ASP.NET Core 的 WebApplicationFactory）启动微服务内存实例，避免依赖外部环境 在 CI/CD 流程中运行 SpecFlow 测试，确保每次变更不破坏已有行为 结合日志或 Mock 外部依赖（如数据库、消息队列），保证测试稳定最佳实践建议
保持 Gherkin 场景简洁，聚焦单一行为 使用 Scenario Outline 和例子表减少重复场景 避免在 Gherkin 中写技术细节，保持业务可读性 定期与产品、测试团队评审 .feature 文件，确保需求对齐基本上就这些。通过 Gherkin + SpecFlow，.NET 微服务可以实现清晰、可执行的行为文档，提升质量与协作效率。
