Maven 项目构建时编译错误问题排查与解决

1. 问题描述

Maven 项目执行命令 mvn clean package 时出现编译错误,如下图所示

2. 问题分析

由于是源码编译错误,于是通过查看项目 pom.xml 文件,得到项目源码使用的 Java 版本为 21

xml 复制代码
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<properties>
		<maven.compiler.source>21</maven.compiler.source>
		<maven.compiler.target>21</maven.compiler.target>
	</properties>

	<build>
		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-compiler-plugin</artifactId>
				<configuration>
					<!-- 源码的 Java 版本为 21 -->
					<source>${maven.compiler.source}</source>
					<!-- 最终源码编译为的 Java 版本为 21 -->
					<target>${maven.compiler.target}</target>
				</configuration>
			</plugin>
		</plugins>
	</build>
</project>

再执行命令 mvn -v ,可知当前 mvn 命令依赖的 Java 环境是 Java 17,如下图所示,而项目源码需要编译为 Java 21,这相当于要使用 Java 17 编译生成 Java 21 的字节码,导致构建失败。

Maven 本身也是一个 Java 应用,也就是说它本身的运行也是要基于 JVM 的,mvn -v 命令的输出信息中的 Java 版本就是其运行时依赖的 Java 环境;
Maven 的编译器插件 maven-compiler-plugin 其实并不知道如何编译 Java 源码,它实际是调用了 JDK 中的 javac 工具完成编译的,而这里的 javac 工具就是来源于 Maven 运行时依赖的 Java 环境;
javac 工具考虑了向后兼容性,即允许高版本的 javac 将源码编译为与其版本相同或者比其版本低的字节码,但是无法生成比起自身版本更高的字节码;

3. 问题解决

思路方向:升级 Maven 运行时的 Java 版本(即升级对应 javac 工具的版本)。

我们知道,使用 Maven 前,需要提前设置 Java 环境,设置好对应的 JAVA_HOME 环境变量,所以我们可以直接调整系统的环境变量 JAVA_HOME,让其指向 Java 21,再进行项目构建。但是这样调整会影响系统的其它 Maven 项目,其它 Maven 项目不一定都是使用 Java 21 的,所以采用下面的解决方案:

shell 复制代码
# 先在当前命令会话临时设置 JAVA_HOME 环境变量(如果是 Windows 系统,语法稍有不同)
JAVA_HOME=/path/to/java/21
# 再执行命令构建
mvn clean package

注:可以通过查看 $MAVEN_HOME/bin/mvn 运行脚本的源码知道设置 JAVA_HOME 环境变量起作用的原因。

4. 问题记录

个人在解决问题过程中,发现在当前命令会话临时设置 JAVA_HOME 环境变量一直无法生效,后面经过一番艰辛探索,发现是个人系统存在 mavenrc 的相关文件导致的,该文件是 ~/.mavenrc,其文件内容为:

shell 复制代码
export JAVA_HOME=/usr/local/java/jdk-17.0.1

而 $MAVEN_HOME/bin/mvn 运行脚本会加载该文件,导致当前命令会话临时设置的 JAVA_HOME 环境变量被覆盖了。

最后,考虑到 ~/.mavenrc 这种文件属于特定平台的配置,而不是 Maven 的标准配置,于是直接删除 ~/.mavenrc 文件,以便顺利解决问题。

相关推荐
jaysee-sjc2 小时前
【黑马点评】Day02:优惠券秒杀与分布式锁
java·分布式·nginx·spring·node.js·tomcat·maven
秋天的怀念_David3 小时前
算法一千零一夜 · 第三十五夜 · 恢复风暴
java·程序人生·算法
考虑考虑3 小时前
JDK27中的加密对象的 PEM 编码
java·后端·java ee
行者-全栈开发3 小时前
SpringBoot + GraalVM 原生编译实战:启动时间从8秒到0.5秒的极致优化
java·spring boot·后端
CoderYanger3 小时前
Java EE 进阶:10. MyBatis-Plus使用(第一弹)
java·spring boot·后端·sql·spring·java-ee·mybatis
大胖爱学习_MJ6 小时前
超越向量检索:用 Spring Boot + Neo4j 手搓 GraphRAG 知识图谱记忆
java·后端·python
吃我一窝jio6 小时前
Java博客极简写作三支柱
java
知识搬运临时工6 小时前
双路服务器跑得比单路慢:JVM 没看见内存的距离
java·后端
吃我一窝jio6 小时前
Java Bug复盘与性能优化实战
java·开发语言·笔记
Flynn Liang7 小时前
Java 序列化也能成为瓶颈:Jackson、Protobuf 与 Redis 序列化的生产实践
java·redis·性能优化·jackson·序列化·protobuf