如何在JDK17项目中引用JDK11构建的Kafka相关自定义类？

核心思路 #

要避免JDK17重新编译或运行JDK11构建的类，关键是让主项目只依赖已编译的二进制字节码而非源码，同时通过构建配置隔离编译过程，必要时做运行时类加载隔离。

具体解决方案 #

• 将Kafka连接模块打包为独立的JDK11编译jar包
  用JDK11单独构建该模块，确保编译参数锁定JDK11版本，避免生成JDK17不兼容的字节码。以Maven为例，在模块的pom.xml中配置：

  <properties>
      <maven.compiler.source>11</maven.compiler.source>
      <maven.compiler.target>11</maven.compiler.target>
      <maven.compiler.release>11</maven.compiler.release>
  </properties>
  

  执行mvn clean package生成jar包，确保该jar包含所有必要的依赖（或通过依赖管理引入），且不包含源码文件。

• 主项目以二进制依赖方式引入该jar
  绝对不要将Kafka连接模块的源码作为主项目的子模块或源码依赖引入。将打包好的jar安装到本地Maven仓库（mvn install）或私有仓库，然后在主项目的pom.xml中添加依赖：

  <dependency>
      <groupId>你的模块groupId</groupId>
      <artifactId>kafka-connector-module</artifactId>
      <version>模块版本号</version>
      <type>jar</type>
      <scope>compile</scope>
  </dependency>
  

  Gradle项目则直接配置依赖指向该二进制jar文件或仓库地址，确保不关联源码集。

• 主项目编译阶段排除Kafka模块的源码编译
  如果主项目不小心引入了Kafka模块的源码，需在编译插件中添加排除规则，阻止JDK17编译这些代码。Maven配置示例：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.11.0</version>
      <configuration>
          <source>17</source>
          <target>17</target>
          <excludes>
              <exclude>com/yourcompany/kafka/**/*.java</exclude>
          </excludes>
      </configuration>
  </plugin>
  

• 运行时类加载隔离（针对仍存在的运行时错误）
  如果运行时出现JDK版本相关的类加载异常，可通过类加载器隔离处理：

  • 在Spring项目中，避免用@ComponentScan自动扫描Kafka模块的类，改用自定义类加载器实例化KafkaConsumerConfiguration相关组件；
  • 也可以检查Kafka客户端版本，Kafka 3.3及以上版本已官方支持JDK17，若能升级Kafka版本，可直接在JDK17项目中使用，省去模块隔离的麻烦。

内容的提问来源于stack exchange，提问作者Sudarshan Reddy Mallela