应避免在返回值中使用无界通配符（如list），因其削弱类型安全、迫使调用方强制转换；推荐改用具体泛型类型（如list）、上界通配符（? extends t）或泛型方法（ list）。
Java中SonarQube报“不要在返回值中使用通配符”（如 List>、Collection>），本质是因泛型通配符削弱了类型安全性，且调用方无法获知具体元素类型，易引发运行时异常或强制转换。重构核心思路是：**明确返回类型的上界或下界，或直接使用具体泛型类型**。
用具体泛型类型替代无界通配符
最直接、推荐的做法是将返回类型从 List> 改为带实际类型参数的泛型，例如 List<string></string> 或 List<user></user>。这要求方法内部能确定元素的具体类型。
- 若方法返回的是统一类型的集合（如所有用户、所有订单），直接声明具体类型
- 若方法需支持多种类型但逻辑一致，可提取为泛型方法：
<t> List<t> findEntities(Class<t> type)</t></t></t> - 避免为“兼容所有类型”而退化为
List<object></object>—— 这虽通过编译，但丧失泛型意义，不推荐
用上界通配符（? extends T）替代无界通配符
当方法只读取集合内容（不添加元素），且返回类型需保持一定灵活性（如返回子类实例列表），可用上界限定。
- 例如：返回
List extends Number>表示返回的是Integer、Double等Number子类的列表 - 调用方可安全地获取元素并赋值给
Number变量，但不能向该列表添加任何对象（除null） - 适用于工厂类、查询接口等“生产者”场景（PECS 原则中的 Producer-Extends）
避免在 public API 中返回无界通配符
无界通配符 ? 在返回类型中会迫使调用方做不安全的强制转换，破坏API契约。
- 检查所有
public方法签名，尤其是工具类、DAO 接口、服务层方法 - 若历史代码已暴露
List>，升级时应保持二进制兼容性：可通过重载新方法 + 标注@Deprecated旧方法逐步迁移 - 内部方法（
private/package-private）若仅限当前类使用且逻辑清晰，可酌情放宽，但仍建议统一风格
配合泛型方法提升复用性与类型安全
当一个工具方法需适配多种类型，优先定义泛型方法而非依赖通配符。
- 错误写法：
public static List> filter(List> list, Predicate<object> p)</object> - 正确写法：
public static <t> List<t> filter(List<t> list, Predicate<t> p)</t></t></t></t> - 泛型方法让编译器推断
T，既保留类型信息，又无需调用方显式指定类型（可省略尖括号）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
