如何用Cucumber-Java从表格X/Y轴生成测试用例并断言结果？

我正在使用Cucumber-Java编写测试用例，想了解是否可以从给定表格的X轴和Y轴生成所有输入用例，并断言输出与(x,y)位置的值匹配。例如，假设有如下表格：

x\y | 0 | 1 | 2 |
A | A0 | A1 | A2 |
B | B0 | B1 | B2 |
C | C0 | C1 | C2 |

希望Cucumber能帮我生成以下9个测试用例：

(A, 0) -> A0
(A, 1) -> A1
(A, 2) -> A2
(B, 0) -> B0
(B, 1) -> B1
(B, 2) -> B2
(C, 0) -> C0
(C, 1) -> C1
(C, 2) -> C2

这在输入空间较大时对保障测试覆盖率很有帮助，请问能否通过Cucumber-Java实现该需求？若可以，具体方法是什么？

完全可以实现这个需求，核心是利用Cucumber的**数据表格（DataTable）**结合参数化逻辑生成笛卡尔积用例，下面分两种场景给出具体实现：

场景1：小表格直接枚举组合 #

如果表格规模不大，直接用Scenario Outline+Examples枚举所有(x,y,预期值)组合，直观易维护：

Feature: 笛卡尔积测试用例验证
  Scenario Outline: 验证(x,y)位置的输出值
    Given 输入X轴值为<x>，Y轴值为<y>
    When 执行被测逻辑
    Then 输出结果应为<expected>

    Examples:
      | x | y | expected |
      | A | 0 | A0       |
      | A | 1 | A1       |
      | A | 2 | A2       |
      | B | 0 | B0       |
      | B | 1 | B1       |
      | B | 2 | B2       |
      | C | 0 | C0       |
      | C | 1 | C1       |
      | C | 2 | C2       |

对应的步骤定义代码：

import io.cucumber.java.en.Given;
import io.cucumber.java.en.Then;
import io.cucumber.java.en.When;
import org.junit.Assert;

public class StepDefinitions {
    private String x;
    private String y;
    private String actualOutput;

    @Given("输入X轴值为{x}，Y轴值为{y}")
    public void inputXY(String xVal, String yVal) {
        x = xVal;
        y = yVal;
    }

    @When("执行被测逻辑")
    public void executeLogic() {
        // 替换为你的实际被测逻辑调用
        actualOutput = x + y;
    }

    @Then("输出结果应为{expected}")
    public void verifyOutput(String expected) {
        Assert.assertEquals(expected, actualOutput);
    }
}

场景2：大表格自动生成笛卡尔积 #

如果表格规模大，手动枚举太繁琐，可以在Feature中传入原始矩阵，通过代码解析生成所有组合：

Feature文件写法 #

Feature: 笛卡尔积测试用例验证
  Scenario: 批量验证所有(x,y)组合的输出值
    Given 测试矩阵如下
      | x\y | 0 | 1 | 2 |
      | A   | A0| A1| A2|
      | B   | B0| B1| B2|
      | C   | C0| C1| C2|
    Then 所有(x,y)组合的输出都符合预期

步骤定义代码 #

import io.cucumber.java.en.Given;
import io.cucumber.java.en.Then;
import io.cucumber.datatable.DataTable;
import org.junit.Assert;
import java.util.List;
import java.util.Map;

public class StepDefinitions {
    private List<Map<String, String>> testMatrix;

    @Given("测试矩阵如下")
    public void loadTestMatrix(DataTable dataTable) {
        testMatrix = dataTable.asMaps(String.class, String.class);
    }

    @Then("所有(x,y)组合的输出都符合预期")
    public void verifyAllCombinations() {
        // 获取所有Y轴列名（排除第一列的x\y）
        List<String> yColumns = testMatrix.get(0).keySet().stream()
                .filter(key -> !key.equals("x\\y"))
                .toList();

        // 遍历每一行X轴数据，再遍历每个Y轴列生成用例
        for (int rowIndex = 1; rowIndex < testMatrix.size(); rowIndex++) {
            Map<String, String> rowData = testMatrix.get(rowIndex);
            String xValue = rowData.get("x\\y");

            for (String y : yColumns) {
                String expected = rowData.get(y);
                // 调用被测逻辑获取实际输出
                String actual = runTestLogic(xValue, y);
                // 断言验证
                Assert.assertEquals(String.format("组合(%s,%s)验证失败", xValue, y), expected, actual);
            }
        }
    }

    // 替换为你的实际被测逻辑方法
    private String runTestLogic(String x, String y) {
        return x + y;
    }
}

关键说明 #

• 小表格优先用Scenario Outline：每个组合会单独生成一个测试用例，在测试报告中能清晰看到每个用例的执行结果。
• 大表格用矩阵解析：减少重复代码，只需维护原始矩阵，代码自动展开所有组合，适合输入空间较大的场景。
• 断言部分：结合JUnit/TestNG的断言工具，可自定义错误提示，方便定位失败用例。

内容的提问来源于stack exchange，提问作者OOD Waterball