You need to enable JavaScript to run this app. Cucumber(Gherkin) 测试步骤中如何正确使用Long类型非字符串参数
优惠活动
大模型
产品
解决方案
定价
更多

Cucumber(Gherkin) 测试步骤中如何正确使用Long类型非字符串参数

Cucumber 实现Long类型参数接收的正确写法

问题核心原因

你之前的匹配失败本质上是两套语法的认知混淆,和Long类型本身没有关系:

  • 步骤定义侧的{类型名}占位符:是Cucumber用于匹配步骤文本、自动完成参数类型转换的内置标记,和Gherkin侧的动态参数语法是完全独立的两套机制。
  • Gherkin侧的<参数名>尖括号写法:仅在Scenario Outline 搭配Examples表格的场景下生效,运行时才会被替换成Examples里的实际值。如果是普通Scenario,尖括号就是纯字面文本,不会做任何动态替换。

你贴的报错日志里,Cucumber自动生成的未实现步骤snippet是an user wants to get a customer <id>,这就是因为它在解析Gherkin的时候,把步骤里的<id>当成了纯字面文本,没有触发动态替换,自然和你写的匹配数字的{long}步骤定义对不上。你之前String类型示例能跑通,是因为给尖括号内容套了双引号,刚好匹配了内置的{string}占位符的匹配规则。

正确实现方式

固定参数的普通Scenario场景

  • Gherkin步骤里直接写实际的数字值,不要加多余的尖括号或引号:
Scenario: Get a customer
  When an user wants to get a customer 123456
  Then an HTTP 200 status together with the requested customer data is returned
  • 步骤定义直接用Cucumber内置的{long}占位符即可,不需要额外做类型转换:
@When("an user wants to get a customer {long}")
public void anUserWantsToGetACustomer(Long id) {
    // 业务逻辑实现
}

多组参数重复执行的Scenario Outline场景

  • Gherkin侧用尖括号标记参数注入位置,数字类型的参数不要套双引号:
Scenario Outline: Get a customer
  When an user wants to get a customer <id>
  Then an HTTP 200 status together with the requested customer data is returned

  Examples:
    | id   |
    | 1001 |
    | 1002 |
    | 1003 |
  • 步骤定义仍然使用内置的{long}占位符,运行时Cucumber会逐行替换Examples里的id值,自动将匹配到的数字字符串转为Long类型传入方法参数,无需手动写字符串转数字的逻辑。

常见踩坑提醒

  • 数字类型参数匹配时,不要给参数值套双引号:Cucumber的{string}占位符仅匹配被双引号包裹的文本内容,{long}仅匹配不带引号的数字序列,混用引号会直接导致匹配失败。
  • 不要在普通Scenario里滥用尖括号写法:普通场景下没有Examples数据源,尖括号内容会被当成固定文本,无法实现动态传参。

内容的提问来源于stack exchange,提问作者Seymour Glass

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 22:15:04