导入Maven依赖后Java可识别但Kotlin与mvn编译提示包不存在怎么办

1 排查依赖scope配置 #

检查项目pom.xml中该依赖的scope属性，避免配置为provided、test这类不会纳入编译类路径的选项。IDEA的Java索引可能存在缓存误判所以能识别类，但Kotlin编译器和Maven编译会严格遵循scope规则，scope错误会直接触发类找不到报错。如果配置错误修改为compile或者不填scope（默认就是compile）即可。

2 校验制品字节码兼容性 #

确认GitLab CI构建该制品时，maven-compiler-plugin配置的目标字节码版本和新项目的编译版本匹配，参考标准配置：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.8.1</version>
  <configuration>
    <source>11</source>
    <target>11</target>
    <release>11</release>
  </configuration>
</plugin>

如果缺少release参数，或者构建时目标字节码版本和新项目Kotlin编译器的目标版本不匹配，会出现类识别异常。你可以执行javap -verbose 依赖内的类名.class查看字节码的major版本，Java 11对应的major版本为55，确认和新项目编译版本一致即可。

3 修正Kotlin Maven插件配置 #

如果是Kotlin/Java混合项目，必须确保kotlin-maven-plugin正确关联了编译类路径，且版本和项目使用的Kotlin版本匹配，参考配置：

<plugin>
  <groupId>org.jetbrains.kotlin</groupId>
  <artifactId>kotlin-maven-plugin</artifactId>
  <version>${kotlin.version}</version>
  <executions>
    <execution>
      <id>compile</id>
      <goals>
        <goal>compile</goal>
      </goals>
      <configuration>
        <sourceDirs>
          <sourceDir>${project.basedir}/src/main/kotlin</sourceDir>
          <sourceDir>${project.basedir}/src/main/java</sourceDir>
        </sourceDirs>
      </configuration>
    </execution>
  </executions>
</plugin>

缺失Java源目录配置、插件版本不匹配都会导致Kotlin编译器无法识别Java依赖的类。

4 清理损坏的本地Maven缓存 #

进入本地Maven仓库默认路径~/.m2/repository/，找到对应依赖的目录整体删除，之后执行mvn clean install -U强制拉取GitLab上的最新制品，避免本地缓存了CI构建的损坏jar包。

5 确认制品打包完整性 #

手动解压该依赖的jar包，确认内部存在你要引用的类的.class文件，部分错误的CI构建配置可能出现只打包源码、未打包编译后字节码，或者包路径和预期不一致的问题。

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