Java泛型上界通配符转换/强制转换错误求助

先来看你的代码和报错信息：

测试代码 #

@Test
public void genericsTest() {
    String s = "x";
    List<? extends String> strings = singletonList(s);
    Optional<Function<String, List<? extends String>>> optionalSelector = Optional.empty();
    optionalSelector.map(selector -> selector.apply(s)).orElse(strings);
}

报错信息 #

java: 不兼容的类型: java.util.List<capture#1 of ? extends java.lang.String> 无法转换为 java.util.List<capture#2 of ? extends java.lang.String>

为什么会出现这个错误？ #

这个问题的核心是Java泛型的通配符捕获机制：

• 当你声明List<? extends String> strings时，编译器会给这个通配符生成一个隐式的「捕获类型」（比如capture#2 of ? extends String），用来代表某个具体的、继承自String的类型——哪怕String是final类（没有子类），编译器也不会利用这个语义简化检查，依然严格按照通配符规则处理。
• 当你调用optionalSelector.map(...)时，map方法返回的Optional<List<? extends String>>里的通配符，又会生成另一个完全独立的捕获类型（capture#1 of ? extends String）。
• 编译器会把这两个捕获类型当成完全不同的类型，哪怕它们的上界都是String，自然就会抛出「无法转换」的错误。

怎么解决这个问题？ #

根据你的场景，有几个不同的解决方案，按推荐程度排序：

1. 利用String的final特性，直接替换通配符为具体类型

因为String是final类，不存在任何子类，所以List<? extends String>和List<String>在实际运行中完全等价。把代码里的通配符全部换成String，就能彻底消除通配符捕获的困扰：

@Test
public void genericsTest() {
    String s = "x";
    List<String> strings = singletonList(s);
    Optional<Function<String, List<String>>> optionalSelector = Optional.empty();
    optionalSelector.map(selector -> selector.apply(s)).orElse(strings);
}

2. 显式指定泛型类型，统一捕获规则

如果你的代码是更复杂场景的简化版（比如实际不是用String，而是用某个非final类），可以通过显式指定map方法的泛型类型，让编译器统一使用同一个捕获类型：

@Test
public void genericsTest() {
    String s = "x";
    List<? extends String> strings = singletonList(s);
    Optional<Function<String, List<? extends String>>> optionalSelector = Optional.empty();
    // 显式指定map的返回类型，强制编译器统一捕获类型
    optionalSelector.<List<? extends String>>map(selector -> selector.apply(s)).orElse(strings);
}

3. 强制类型转换（不推荐）

如果以上方法都不适用，可以用强制类型转换绕过编译器检查，但这会丢失泛型的类型安全性，只有在你能确保类型安全的情况下才建议使用：

@Test
public void genericsTest() {
    String s = "x";
    List<? extends String> strings = singletonList(s);
    Optional<Function<String, List<? extends String>>> optionalSelector = Optional.empty();
    List<? extends String> result = optionalSelector.map(selector -> selector.apply(s))
            .orElse((List<? extends String>) strings);
}

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