SAP Hybris Commerce 6.2 Cuppy项目构建报错：方法名称冲突问题

这是Java泛型类型擦除带来的典型编译错误，在Java 8的严格方法覆盖检查下很容易触发，结合你使用的WS-Core 2.3和Hybris环境，给你具体的解决步骤：

问题根源 #

Java在编译时会擦除泛型类型信息，父类Converter的convertAll(Collection<? extends SOURCE>)和子类GenericCollectionConverter的convertAll(Collection<SOURCE>)擦除后都会变成convertAll(Collection)的原生签名。但Java 8对方法覆盖的规则更严格：子类方法的泛型签名必须和父类完全匹配才能被识别为覆盖，否则编译器会判定为重复定义的方法，抛出名称冲突错误。

解决步骤 #

1. 修改子类方法签名，严格匹配父类 #

打开de.hybris.platform.cuppy.web.converters.GenericCollectionConverter类，把convertAll方法的签名改成和父类Converter完全一致的版本，并且加上@Override注解强制编译器校验：

import de.hybris.platform.servicelayer.dto.converter.Converter;
import java.util.ArrayList;
import java.util.Collection;

public class GenericCollectionConverter<SOURCE, TARGET> implements Converter<SOURCE, TARGET> {

    // 其他已实现方法...

    @Override
    public Collection<TARGET> convertAll(Collection<? extends SOURCE> sources) {
        Collection<TARGET> targets = new ArrayList<>();
        for (SOURCE source : sources) {
            targets.add(convert(source));
        }
        return targets;
    }
}

@Override注解非常关键，它能帮你在编译阶段就发现签名不匹配的问题，避免后续运行时的潜在错误。

2. 确保Ant编译任务启用Java 8支持 #

检查项目的build.xml文件，确认编译任务的source和target参数都设置为1.8，保证编译器按照Java 8的规则处理泛型和方法覆盖：

<javac 
    srcdir="${src.main.java}" 
    destdir="${build.classes.dir}" 
    source="1.8" 
    target="1.8" 
    encoding="UTF-8"
    debug="true"
>
    <classpath refid="project.classpath"/>
</javac>

如果编译级别低于1.8，不仅会触发这个泛型错误，还可能导致其他Java 8特性无法正常工作。

3. 清理残留编译文件后重新执行Ant命令 #

先手动删除项目的编译输出目录（比如bin、build或target文件夹），避免旧的class文件干扰新编译结果，然后再执行：

ant clean all

额外说明 #

这种问题在Java 7及之前的版本中可能不会出现，因为Java 8对方法覆盖的泛型兼容性检查做了强化。WS-Core 2.3中的Converter接口使用了带通配符的方法签名，目的是让方法能接收更宽泛的集合类型，所以子类必须严格匹配这个签名才能正确实现覆盖。

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