Hybris OCC创建WsDtoDataList时报java.lang.IllegalArgumentException错误

java.lang.IllegalArgumentException: Invalid class name identifier java.util.List<de.hybris.platform.commercewebservicescommons.dto.traininguserdetails.trainingUserDetailsWsDTO

该报错的核心原因是Hybris的beans.xml配置解析规则不支持直接在type属性中拼接泛型声明，解析器会把完整的java.util.List<xxx>字符串整体当做类名处理，自然无法识别出合法的类标识符。

修正配置写法 #

Hybris中定义带泛型的集合类型属性，需要分开指定集合类型和泛型类型：

• type属性仅填写集合本身的全限定类名，例如java.util.List
• 新增genericType属性，填写泛型对应的DTO全限定类名

修正后的配置如下：

<bean class="de.hybris.platform.commercewebservicescommons.dto.traininguserdetails.trainingUserDetailsDataListWsDTO">
    <property 
        name="trainingUserDetails" 
        type="java.util.List"
        genericType="de.hybris.platform.commercewebservicescommons.dto.traininguserdetails.trainingUserDetailsWsDTO"
    />
</bean>

额外检查项 #

• 确认de.hybris.platform.commercewebservicescommons.dto.traininguserdetails.trainingUserDetailsWsDTO本身已经在当前扩展或依赖扩展的beans.xml中完成定义，保证该DTO类可被正常加载
• 检查类名大小写是否与实际定义一致，Java类名通常遵循大驼峰命名规范，若你实际定义的DTO类名为TrainingUserDetailsWsDTO（首字母大写），配置中类名全小写也会触发类找不到的错误

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