使用Maven编译Java+Scala混合Spring Boot项目失败求助

这种情况我碰到过好多次——IDEA里跑的好好的，一用mvn clean install就报错，核心原因就是Maven的编译阶段顺序不对：Java编译器先执行了，但这时候Scala类还没被编译，自然会报找不到符号的错误；而IDEA的内置构建器会自动处理Scala和Java的编译依赖顺序，所以不会有问题。

给你几个针对性的解决方案，按优先级来：

1. 强制让Scala编译先于Java编译 #

Spring Boot的parent pom默认已经配置了maven-compiler-plugin，它会在compile阶段执行，但你的scala-maven-plugin虽然配置了compile阶段，却没有明确指定它要在Java编译器之前运行。你需要显式声明maven-compiler-plugin，并调整插件的执行顺序：

修改你的<build>部分，添加maven-compiler-plugin并调整插件顺序：

<build>
    <plugins>
        <!-- 先配置Scala编译插件，确保它先执行 -->
        <plugin>
            <groupId>net.alchim31.maven</groupId>
            <artifactId>scala-maven-plugin</artifactId>
            <version>3.2.1</version>
            <executions>
                <execution>
                    <id>compile-scala</id>
                    <phase>process-resources</phase> <!-- 提前到process-resources阶段执行 -->
                    <goals>
                        <goal>add-source</goal>
                        <goal>compile</goal>
                    </goals>
                </execution>
                <execution>
                    <id>test-compile-scala</id>
                    <phase>process-test-resources</phase>
                    <goals>
                        <goal>add-source</goal>
                        <goal>testCompile</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <recompileMode>incremental</recompileMode>
                <scalaVersion>${scala.version}</scalaVersion>
                <args>
                    <arg>-deprecation</arg>
                </args>
                <jvmArgs>
                    <jvmArg>-Xms64m</jvmArg>
                    <jvmArg>-Xmx1024m</jvmArg>
                </jvmArgs>
            </configuration>
        </plugin>

        <!-- 显式配置Java编译插件，确保在Scala编译之后 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version> <!-- 用Spring Boot parent兼容的版本 -->
            <executions>
                <execution>
                    <id>default-compile</id>
                    <phase>compile</phase>
                    <goals>
                        <goal>compile</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <source>${java.version}</source>
                <target>${java.version}</target>
            </configuration>
        </plugin>

        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

这里把Scala编译的阶段提前到process-resources，这样在Java编译的compile阶段之前，Scala类已经被编译成class文件了，Java代码就能找到它们。

2. 确认Scala源码目录结构 #

scala-maven-plugin默认会扫描src/main/scala和src/test/scala目录下的Scala文件，如果你把Scala代码放在src/main/java目录里，Maven编译时可能不会识别（IDEA会自动识别，但Maven不会）。所以请确保你的Scala代码放在正确的目录下：

src/
├─ main/
│  ├─ java/       # Java代码
│  └─ scala/      # Scala代码
└─ test/
   ├─ java/
   └─ scala/

3. 排除不必要的依赖 #

你的依赖里加了scala-compiler，这个在运行时是不需要的，而且可能带来版本冲突风险，建议把它的<scope>改成provided或者直接移除：

<dependency>
    <groupId>org.scala-lang</groupId>
    <artifactId>scala-compiler</artifactId>
    <version>${scala.version}</version>
    <scope>provided</scope> <!-- 只在编译时需要 -->
</dependency>

做完这些修改后，再执行mvn clean install试试，应该就能正常编译了。

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