将Cucumber从3x升级至7x时遇UndefinedDataTableTypeException问题求助

问题原因 #

Cucumber 7.x版本移除了3.x中对自定义对象的自动DataTable映射逻辑，必须显式注册行转换器或条目转换器，才能将DataTable转换为自定义对象列表。

解决方案 #

方法1：注册行转换器（推荐） #

创建一个Cucumber配置类，用@DataTableType注解定义DataTable行转Config对象的逻辑：

import io.cucumber.datatable.DataTableType;
import java.util.Map;

// 该类需被Cucumber的glue路径扫描到，可放在step定义同包下
public class CucumberDataTableConfig {

    @DataTableType
    public Config mapToConfig(Map<String, String> row) {
        // 根据你的Config类实际属性，从row中取对应字段赋值
        return Config.builder()
                .configKey(row.get("configKey")) // 替换为Config类的真实属性名
                .configValue(row.get("configValue"))
                .build();
    }
}

方法2：使用默认转换器（简化场景） #

如果Config类有无参构造函数+对应setter，或有匹配DataTable列名的全参构造函数，可通过默认转换器自动映射：

import io.cucumber.datatable.DefaultDataTableEntryTransformer;
import io.cucumber.datatable.TableEntryTransformer;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.lang.reflect.Type;

public class CucumberDataTableConfig {

    @DefaultDataTableEntryTransformer
    public TableEntryTransformer<Object> defaultTransformer() {
        ObjectMapper mapper = new ObjectMapper();
        return (entry, type) -> mapper.convertValue(entry, type);
    }
}

注意事项 #

• 确保配置类所在包被Cucumber的glue参数覆盖（可在运行配置或cucumber.properties中指定）
• DataTable列名需与Config类属性名对应（大小写敏感，可通过Jackson注解调整映射规则）
• 若用Builder模式，需保证Builder方法名与列名匹配（如列名config-key对应Builder方法configKey()）

内容的提问来源于stack exchange，提问作者Tohid Makari