Apache Commons Collections ListUtils.union返回raw List与文档不符疑问

你没有误读官方文档，出现这个问题的核心原因是你查看的API文档版本和实际引入的依赖版本不一致。

• commons-collections 3.x 版本（你当前引入的3.2属于这个大版本）发布时间较早，没有适配Java 5引入的泛型特性，所有集合操作方法返回的都是原生List类型，这就是你本地看到方法签名返回raw List、触发编译器警告的根本原因。
• 你查阅的是commons-collections4（也就是4.x大版本）的API文档，4.x版本是Apache后续重构的迭代版本，最低依赖Java 5，全量适配了泛型，所以对应union()方法的返回值才标注为List<E>。

如果要消除警告，有两种可选方案：

1. 升级依赖到commons-collections4版本，替换原有pom依赖：

<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-collections4</artifactId>
  <version>4.4</version>
</dependency>

修改对应工具类的导入路径为org.apache.commons.collections4.ListUtils，即可直接获取带泛型的返回值，无转换警告。
2. 若因项目兼容要求必须保留3.2版本依赖，可在对应代码行或者所属方法上添加@SuppressWarnings("unchecked")注解忽略未检查转换警告，需自行保证返回值类型符合预期，不会出现类型转换异常。

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