Cucumber-Java多短语匹配步骤定义识别失败问题求助

一、核心问题原因 #

Cucumber 7.x版本默认使用Cucumber表达式而非传统正则表达式，你原代码中(created)/(requests to create)是正则分支语法，不符合Cucumber表达式规则，因此无法匹配步骤。

二、正确的步骤定义写法 #

方式1：使用Cucumber表达式的可选分支语法 #

Cucumber表达式用(text1|text2)表示二选一的可选文本，直接替换原斜杠分隔写法即可：

// 用非捕获组(?:...)避免生成多余参数，方法仅保留所需的code参数
@Given("client (?:created|requests to create) application for code {string}")
public void client_operate_application_for_code(String code) {
    // 业务逻辑代码
}

对应的Feature文件步骤无需修改：

# Feature文件1
Given client created application for code 200

# Feature文件2
Given client requests to create application for code 201

方式2：强制使用正则表达式模式 #

若习惯正则语法，需在步骤字符串前添加regexp:前缀，明确告知Cucumber使用正则解析：

// 正则非捕获组(?:...)避免生成多余参数，\\w+匹配代码字符串
@Given("regexp: client (?:created|requests to create) application for code (\\w+)")
public void client_operate_application_for_code(String code) {
    // 业务逻辑代码
}

注意：Java字符串中，正则的反斜杠需转义为两个\\；若要匹配字面量括号，正则里需写\\(和\\)。

三、Cucumber表达式的正确转义规则 #

Cucumber表达式中，以下特殊字符需用反斜杠转义（Java字符串中需写为\\）：

• 括号：匹配字面量(/)时，需写成\\(/\\)
• 竖线：匹配字面量|时，需写成\\|
• 大括号：匹配字面量{/}时，需写成\\{/\\}
• 反斜杠：匹配字面量\时，需写成\\\\（Java字符串转义一次，Cucumber表达式再转义一次）

示例：匹配步骤client (created) application for code {200}的定义：

@Given("client \\(created\\) application for code \\{string}")
public void client_step(String code) {
    // 业务逻辑代码
}

内容的提问来源于stack exchange，提问作者Phalguna Aramalla