升级Java构建运行时至17后遇Record歧义引用问题求解决

问题原因 #

Java 17在java.lang包中新增了Record类，而你使用的jOOQ框架包含org.jooq.Record接口。尽管你将源码和目标版本保持为11，但构建时使用的Java 17编译器会识别到运行时环境中的java.lang.Record。当代码中使用未限定类名Record时，编译器无法区分要引用的是jOOQ的Record接口还是Java 17新增的Record类，因此抛出歧义错误。

解决方法 #

• 明确限定类名：在所有引用Record的代码位置，使用全限定类名org.jooq.Record替代裸写的Record，让编译器直接定位到jOOQ的接口。
• 升级jOOQ版本：较新版本的jOOQ已经针对Java 17的java.lang.Record做了兼容适配，升级到兼容Java 17的jOOQ版本可自动消除这个歧义。
• 正确配置编译参数：确保构建工具（如Maven/Gradle）的编译参数使用--release 11（而非仅设置source和target）。以Maven为例，在maven-compiler-plugin中配置<release>11</release>，让编译器严格按照Java 11的API范围处理代码，不会加载Java 17新增的java.lang.Record，从而避免冲突。

内容的提问来源于stack exchange，提问作者Luan Kevin Ferreira