如何确保开发多适配Java版本的内部库时，不会无意依赖高版本Java专属代码？

这个问题我之前维护多版本适配的内部组件库时也踩过坑——光靠设置maven-compiler-plugin的source和target参数真的不够，它们只是控制生成的字节码版本，根本不会检查你代码里是不是偷偷用了高版本Java才有的API（比如Java11的HttpClient，要是你用Java17构建但target设成8，编译能过，但放到Java8环境跑就直接炸）。

给你几个经过实践验证的靠谱方案，从编译检查到运行验证全覆盖：

• 用release参数替代source/target
  Maven的maven-compiler-plugin从3.6版本开始支持release参数，它不仅会生成对应版本的字节码，还会严格检查代码中使用的API是否属于目标Java版本的标准库。比如你要适配Java8，直接在插件配置里设：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
      <release>8</release>
    </configuration>
  </plugin>
  

  这样哪怕你用Java17来构建，只要release设成8，代码里一用Java9+的API，编译阶段就直接报错，从源头拦住问题。

• 用Animal Sniffer做全链路API检查
  如果你的项目还依赖了第三方库，光靠release可能不够——有些第三方库可能偷偷依赖了高版本Java API，编译时不会报错，但运行时就出问题。这时候可以用Animal Sniffer插件，它能扫描你的代码+所有依赖，确保没有超出目标Java版本的API调用。
  配置也很简单，先引入插件，再指定对应Java版本的signature：

  <plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>animal-sniffer-maven-plugin</artifactId>
    <version>1.23</version>
    <executions>
      <execution>
        <id>check-java-api</id>
        <phase>verify</phase>
        <goals>
          <goal>check</goal>
        </goals>
      </execution>
    </executions>
    <configuration>
      <signature>
        <groupId>org.codehaus.mojo.signature</groupId>
        <artifactId>java17</artifactId> <!-- 换成你要适配的版本，比如java8 -->
        <version>1.0</version>
      </signature>
    </configuration>
  </plugin>
  

  构建时它会帮你把所有违规的API调用揪出来，连第三方依赖的问题都不放过。

• 给每个子模块单独配置版本规则
  既然你的reactor pom要管理多个适配不同Java版本的库，完全可以给每个子模块单独设置对应的release参数或者Animal Sniffer规则。比如在父pom里定义不同的properties，子模块按需引用：
  父pom里：

  <properties>
    <java.version.moduleA>8</java.version.moduleA>
    <java.version.moduleB>11</java.version.moduleB>
  </properties>
  

  子模块A的pom里：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
      <release>${java.version.moduleA}</release>
    </configuration>
  </plugin>
  

  这样一次构建时，每个子模块都会按照自己的目标Java版本做严格检查，互不干扰。

• 用对应版本的Java跑单元测试
  就算编译阶段都通过了，还是要确保在目标Java环境下能正常运行。可以用Maven的toolchains插件，给每个子模块指定运行测试用的Java版本，比如子模块A用Java8跑测试，子模块B用Java11跑：
  先在~/.m2/toolchains.xml里配置好各个版本的JDK路径，然后在子模块的pom里配置插件：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-toolchains-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
      <execution>
        <goals>
          <goal>toolchain</goal>
        </goals>
      </execution>
    </executions>
    <configuration>
      <toolchains>
        <jdk>
          <version>1.8</version>
          <vendor>oracle</vendor>
        </jdk>
      </toolchains>
    </configuration>
  </plugin>
  

  这样测试阶段就会用目标版本的Java运行，能提前发现运行时才会出现的兼容性问题。

内容来源于stack exchange