TestNG DataProvider返回Iterator<Airline>不符合文档却可运行的原因咨询

问题场景 #

根据TestNG官方文档，DataProvider必须返回Object[][]或Iterator<Object[]>类型，但我编写了返回Iterator<Airline>类型的DataProvider方法，代码如下：

@DataProvider(name = "airlineData")
public Iterator<Airline> getCreateAirlineData() throws IOException {
    List<LinkedHashMap<String, String>> excelDataAsListOfMap = ExcelUtils.getExcelDataAsListOfMap("CreateAirlineData", "Sheet1");
    List<Airline> airlineData = new ArrayList<>();
    for(LinkedHashMap<String,String> data : excelDataAsListOfMap) {
        Airline airline = Airline.builder()
                .id(Integer.parseInt(data.get("Id")))
                .name(data.get("Name"))
                .country(data.get("Country"))
                .logo(data.get("Logo"))
                .established(data.get("Established"))
                .website(data.get("Website"))
                .slogan(data.get("Slogan"))
                .head_quaters(data.get("HeadQuarter"))
                .build();
        airlineData.add(airline);
    }
    return airlineData.iterator();
}

测试方法使用该DataProvider的代码：

@Test(dataProvider = "airlineData" )
public void createAirlineAndVerify(Airline airline) {
    Response response = createAirline(airline);
}

实际运行时测试可正常执行且无编译错误，仅在IntelliJ中返回类型被标红，想知道这一现象的原因。

原因解释 #

• Java泛型擦除机制：Java泛型是编译期特性，运行时会被擦除。Iterator<Airline>在字节码层面和Iterator<Object[]>本质都是Iterator，TestNG运行时只会检查是否为Iterator类型，不会校验泛型参数，因此能正常识别并遍历数据。
• TestNG参数匹配逻辑：你的测试方法只接收一个Airline类型的参数，TestNG在遍历Iterator时，会把每个Airline实例自动包装成单元素的参数数组（相当于Object[]{airline}），刚好匹配测试方法的签名，所以能顺利执行测试。
• IDE静态检查vs运行时兼容：IntelliJ的标红是IDE基于TestNG文档规范做的静态代码提示，它严格遵循官方要求的返回类型，但这只是IDE层面的警告，不会影响代码编译和TestNG的运行时执行。

内容的提问来源于stack exchange，提问作者AMOD MAHAJAN