Java泛型与Stream API配合的核心是编译期类型推断、泛型约束和方法签名锚定，三者协同实现类型安全；需确保源头泛型声明、优先使用方法引用、collect时显式指定构造器、处理Class转换需类型投影、注意boxed/unboxed边界。
Java 中泛型与 Stream API 的配合，核心在于编译期类型推断 + 泛型约束 + 方法签名锚定，三者协同才能实现真正类型安全的流式转换。它不是靠运行时检查，而是让编译器在写代码时就“看清”每一步的输入和输出类型，避免强转、避免 ClassCastException、也减少 Optional 或 instanceof 的补救式写法。
泛型边界决定 Stream 操作的合法性
Stream 的中间操作（如 map、filter、flatMap）和终止操作（如 collect、forEach）都依赖泛型参数传递类型信息。如果源头集合或流没有明确泛型，类型链会断裂：
✅ 正确：
List<String> list = ...; list.stream().map(String::length).forEach(System.out::println);
编译器从List<String>推出Stream<String>，再结合String::length返回int，自动匹配为IntStream，后续可调sum()等原生方法。❌ 危险：
List list = new ArrayList(); list.stream().map(s -> s.toString())list是 raw 类型，stream()返回Stream<Object>，s被当作Object，.toString()虽能执行，但一旦s为null就 NPE；更严重的是，后续若想.mapToInt(...)，编译器无法确认s可转为int，必须加(String) s强转——这就绕过了泛型保护。
所以第一步永远是：确保源头带泛型声明，不写 List，而写 List<String>、Map<Long, User> 等。
立即学习“Java免费学习笔记（深入）”；
方法引用比 Lambda 更稳地保全类型信息
Lambda 表达式在类型上下文模糊时容易触发推断失败；方法引用则绑定具体类的方法签名，把类型“钉死”：
-
stream.map(Integer::parseInt)→ 输入必须是String（因parseInt(String)），输出必为int，编译器直接推为IntStream -
stream.map(s -> Integer.parseInt(s))→ 若s类型不明确（比如来自Stream<?>或反射结果），编译器可能报错或退化为Stream<Object>，迫使你写s -> ((String)s).parseInt(...)，引入强转风险
尤其在嵌套流中（如 flatMap 后接 map），方法引用能延续类型上下文，Lambda 则更容易丢失。
收集到泛型集合需显式提供构造逻辑
collect(Collectors.toList()) 返回 List<T>，但如果你想要特定子类型（如 LinkedList<T> 或自定义 MyList<T>），不能只靠泛型参数自动推导：
// ❌ 编译失败：无法将 List<T> 强转为 LinkedList<T>
List<String> src = Arrays.asList("a", "b");
LinkedList<String> result = src.stream().collect(Collectors.toList());
// ✅ 正确：用 Supplier 明确指定目标类型
LinkedList<String> result = src.stream()
.collect(Collectors.toCollection(LinkedList::new));这是因为 Collectors.toCollection(Supplier<C>) 接收一个工厂函数，把类型创建责任交给调用方，绕过泛型擦除带来的实例化限制。
处理 Class<?> 转换时，asSubclass 需配合类型投影
当从 Stream<Class<?>> 过滤并转成 Class<? extends RuntimeException> 时，仅靠 x.asSubclass(RuntimeException.class) 不够：
-
javac通常能推，但 Eclipse（ECJ）会卡在通配符捕获上，报错：cannot convert from Class<capture#1-of ? extends RuntimeException> - 解决方案是加类型投影，强制 map 输出类型：
classes.stream()
.filter(RuntimeException.class::isAssignableFrom)
.<Class<? extends RuntimeException>>map(x -> x.asSubclass(RuntimeException.class))
.forEach(handler::register);这行 <Class<? extends RuntimeException>> 不是冗余语法，而是告诉编译器：“这个 map 的输出就是你要的类型”，从而满足下游 Class<? extends Exception> 参数的要求。
boxed/unboxed 要匹配原始流与引用流的边界
基本类型流（IntStream）和引用类型流（Stream<Integer>）之间不能自动互转：
-
Arrays.stream(new int[]{1,2,3})→IntStream，不能直接.collect(Collectors.toList()) - 必须
.boxed()才能进泛型集合操作 - 反过来，
Stream<Integer>想用sum()，就得.mapToInt(Integer::intValue)转回IntStream
注意空值风险：Stream<Integer> 含 null 时，.mapToInt(Integer::intValue) 直接抛 NullPointerException；而 .boxed() 本身不会空指针，但后续操作可能暴露它。
不复杂但容易忽略
