Cucumber Java步骤中含破折号的可选正则参数无法匹配问题

问题复现 #

使用Cucumber Java开展自动化测试开发时，如果步骤定义注解的正则匹配规则中，参数可选值包含破折号，例如下方代码：

@And("^In history \"(.*)\" smth (opt1|opt2t---wo)$")
public void check() {

}

会出现两类异常表现：

• IDE中的Cucumber插件会将该步骤以<param>占位符形式展示
• 执行测试时无法匹配到对应步骤定义，直接标记为UNKNOWN STEP（未知步骤）
  如果移除可选参数中的破折号，改为无破折号的匹配规则：

@And("^In history \"(.*)\" smth (opt1|opt2two)$")
public void check() {

}

步骤即可被Cucumber正常识别：插件端能正确展示为独立步骤条目，运行时也可正常匹配到绑定方法，功能表现符合预期。
此前尝试在破折号前添加反斜杠转义修复，例如下方写法，未产生任何效果：

@And("^In history \"(.*)\" smth (opt1|opt2-two)$")

根因说明 #

该问题并非正则语法错误导致，而是低版本Cucumber的解析逻辑bug：Cucumber加载步骤定义时，会先对注解内的字符串做一轮Cucumber表达式预解析，即使字符串写了^/$正则锚点，预解析逻辑依然会把裸破折号识别为自定义参数类型的分隔标记，导致后续正则匹配链路断裂，最终出现插件显示异常、运行时匹配失败的问题。
单斜杠转义\-无效的原因有两点：

• Java字符串中反斜杠本身需要双写转义，单斜杠写法本身就不符合Java字符串语法
• 这种转义仅在正则匹配阶段生效，无法绕过Cucumber前置的预解析逻辑

修复方案 #

可根据实际项目情况任选一种方案修复：

方案1：升级Cucumber依赖版本到7.0及以上 #

7.0及以上版本修复了正则模式下特殊字符误解析的问题，只要正则本身语法正确，包含破折号的匹配规则不需要额外处理即可正常识别、匹配。

方案2：低版本兼容写法 #

如果暂时无法升级依赖，不要在捕获组的备选分支中直接写裸破折号，用正则字面量包裹包含破折号的匹配项即可绕过预解析逻辑，参考写法如下：

// 用\Q \E 包裹带特殊字符的匹配项，区域内所有字符按普通字符串匹配
@And("^In history \"(.*)\" smth (opt1|\\Qopt2t---wo\\E)$")
public void check() {

}

也可以将破折号放入字符组中匹配，同样可以绕过预解析：

// 连续3个破折号用字符组+量词的形式书写
@And("^In history \"(.*)\" smth (opt1|opt2t[-]{3}wo)$")
public void check() {

}

注意：低版本场景下不推荐用双斜杠转义破折号（\\-）的写法，部分小版本中该写法依然会被预解析逻辑误识别，用字面量包裹的兼容性最稳定。

内容的提问来源于stack exchange，提问作者Albert Vesker