当方法需统一返回 List 或 List 时，应避免使用泛型通配符 List

当方法需统一返回 `list` 或 `list` 时，应避免使用泛型通配符 `list extends parent>` 作为返回类型（sonarqube 禁止），而应统一返回 `list`，并通过构造新列表将 `list` 安全转为 `list`。

在 Java 泛型中，List<child></child> 并非 List<parent></parent> 的子类型——这是由泛型的不变性（invariance）决定的。因此，直接返回不同具体类型的列表会导致类型不兼容。虽然 List extends Parent> 在语义上看似合理（表示“某个 Parent 子类型的列表”），但它会削弱调用端的类型安全性与可操作性：调用方无法向该列表添加任何元素（包括 Parent 或 Child 实例），且 SonarQube 明确将其标记为 Critical 级别问题（RSPEC-1452），因其暗示设计意图模糊、API 不够清晰。

✅ 正确做法是：统一返回 List<parent></parent>，并在必要时将子类列表显式转换为父类列表：

public class Parent {
    public List<parent> getListOfStuff(boolean p) {
        return p
            ? myOtherMethodThatReturnsListOfParents()
            : new ArrayList(myOtherMethodThatReturnsListOfChildren());
    }

    private List<parent> myOtherMethodThatReturnsListOfParents() {
        return List.of(new Parent(), new Parent());
    }

    private List<child> myOtherMethodThatReturnsListOfChildren() {
        return List.of(new Child(), new Child());
    }
}</child></parent></parent>

此处 new ArrayList(listOfChildren) 利用了 ArrayList 的构造函数接受 Collection extends Parent>（因 Child 是 Parent 的子类），安全地将 List<child></child> 转换为 List<parent></parent>。该列表内容仍保留原始对象的运行时类型（即 Child 实例仍是 Child），仅编译时视作 Parent 元素，完全符合里氏替换原则。

⚠️ 注意事项：

• 不要尝试强制类型转换（如 (List<parent>) (List>) listOfChildren</parent>），这会绕过泛型检查，引发 ClassCastException 风险；
• 若需区分元素具体类型，可在遍历时使用 instanceof 或 getClass()，例如：

  for (Parent item : result) {
      if (item instanceof Child child) {
          // 处理 Child 特有逻辑
      } else {
          // 处理 Parent 或其他子类
      }
  }

• 若业务上频繁需要按子类型分发逻辑，可考虑引入访问者模式或策略接口，而非在每个调用点重复类型判断。

总结：面向抽象编程的核心在于返回最宽泛但足够精确的公共类型（这里是 List<parent></parent>），配合安全的集合构造与运行时类型识别，既满足静态类型检查、通过 Sonar 规则，又保持语义清晰与扩展性。