升级Kotlin至1.2.21后Maven编译出现Classpath路径不存在警告问题排查

咱们来一步步拆解这个问题，结合我对Kotlin Maven插件和IDE构建流程的经验，给你理清楚来龙去脉和解决办法：

1. 命令行与IntelliJ构建差异的本质 #

IntelliJ和Maven命令行的构建逻辑是完全独立的：

• IntelliJ用自己的内置构建引擎，会直接根据项目配置生成classes和test-classes目录，并且会提前协调Kotlin编译的依赖与输出路径，不需要严格遵循Maven的生命周期顺序。
• 而Maven命令行严格按照标准生命周期执行阶段任务，Kotlin 1.2.21版本的Maven插件调整了编译阶段的执行逻辑，导致在verify阶段运行时，Maven默认的target/classes目录还未生成（反而先创建了Kotlin增量编译缓存目录kotlin-ic），插件检查类路径时就会触发警告。

2. 警告（转为错误）的触发原因 #

这个警告是Kotlin 1.2.21版本Maven插件的行为变更导致的：

• 插件在编译前会校验类路径上的所有条目是否存在，当它发现配置中指向的target/classes目录还未被创建（因为生命周期顺序问题，Kotlin编译阶段的执行时机早于该目录的生成时机），就会抛出路径不存在的警告。
• 由于你开启了-Werror参数，所有警告都会被转为编译错误，最终导致mvn verify失败。

方法一：明确指定Kotlin插件的输出目录 #

在pom.xml中给Kotlin Maven插件配置明确的输出路径，和Maven的标准目录对齐，避免插件找不到路径：

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

方法二：提前创建输出目录 #

在Maven的initialize阶段添加插件，提前生成target/classes和target/test-classes目录，让Kotlin插件检查时路径已存在：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <executions>
        <execution>
            <id>make-output-directories</id>
            <phase>initialize</phase>
            <goals>
                <goal>mkdirs</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.outputDirectory}</outputDirectory>
                <testOutputDirectory>${project.build.testOutputDirectory}</testOutputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

方法三：升级到更高版本的Kotlin插件 #

这个路径检查的问题在Kotlin 1.2.30及以上版本的Maven插件中已经被修复了，JetBrains调整了插件的类路径校验逻辑，不会再因为目录未提前创建而抛出警告。直接升级Kotlin版本到1.2.30+，既能解决当前问题，还能获得更多bug修复和特性。

临时方案：暂时关闭-Werror（不推荐） #

如果只是紧急需要通过构建，可以临时移除-Werror参数，但这会忽略其他潜在的代码警告，不利于代码质量管控，不建议长期使用。

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