Cucumber-java 6.10.4自定义@ParameterType不生效无法转换List<String>

问题原因 #

你使用了传统正则表达式格式的步骤定义，这种模式下Cucumber优先使用内置转换器处理捕获组内容，由于泛型擦除，无法匹配到你注册的返回List<String>的自定义参数类型，因此走默认转换器抛出错误。

解决步骤 #

1. 优化自定义参数类型配置，兼容单元素场景，对齐原有@Delimiter("; ")的拆分逻辑：

@ParameterType(value = "[^;]+(?:; [^;]+)*", preferForRegexMatch = true)
public List<String> stringList(String raw) {
    // 按原分隔符"; "拆分，避免元素残留多余空格
    return Arrays.asList(raw.split("; "));
}

preferForRegexMatch = true 配置表示该参数类型可优先用于正则捕获组的类型转换，如果你后续改成Cucumber表达式可以去掉这个属性。

2. （更推荐）修改步骤定义为Cucumber表达式，显式引用自定义参数类型，替换原有正则捕获组：

// 去掉正则锚点和捕获组，直接用{stringList}引用自定义参数类型
@Then("there are error messages: \"{stringList}\"")
public void assertAllMessages(List<String> messages) throws Exception {
  // 原有方法逻辑完全不变
}

这种写法是Cucumber官方推荐的参数类型使用方式，不会受泛型擦除影响，匹配逻辑更稳定。

修改完成后重新运行测试即可正常完成参数转换。

内容的提问来源于stack exchange，提问作者Roddy of the Frozen Peas