Spring Reactive WebClient使用菱形语法的ParameterizedTypeReference编译失败

为什么显式指定类型能解决编译问题？ #

这是Java 11 javac编译器的已知bug：当编译器尝试通过上下文自动推断ParameterizedTypeReference的泛型类型时，会触发空指针异常（NPE），导致编译流程崩溃。

具体原理 #

ParameterizedTypeReference是Spring用来保留泛型类型信息的工具类，它通过匿名内部类的方式绕过Java的类型擦除机制。当你使用菱形运算符<>让编译器自动推断目标类型时，Java 11的编译器在解析Flux<List<CustomerData>>这个上下文类型时存在逻辑缺陷，无法正确生成类型信息，进而在Flow$FlowAnalyzer.visitApply方法中抛出NPE。

而显式指定ParameterizedTypeReference<List<CustomerData>>后，编译器无需进行复杂的上下文推断，直接获取到明确的泛型类型，编译流程就能正常执行。

IDE提示的矛盾原因 #

IntelliJ IDEA的代码检查器能正确推断出类型，所以会提示你移除显式类型，但IDE的静态分析逻辑和javac的编译逻辑并不完全同步——它没有识别到javac本身存在的这个bug，才会给出不符合实际编译情况的建议。

可行的解决办法 #

• 保留显式泛型声明：继续使用new ParameterizedTypeReference<List<CustomerData>>()，这是最直接且无副作用的方案。
• 升级JDK版本：该bug在Java 17及后续版本中已被修复，若项目允许升级JDK，也能彻底解决这个问题。

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