最近研究开源监控平台Hertzbeat于是github上fork了这个项目master版本日期20251120把代码拉到本地跑起来。Hertzbeat属于父子模块项目通过前后端进行部署。Maven构建时软件版本要求Maven3JDK17及以上。踩了很多坑简单做个回顾。启动步骤1.Github拉取项目https://github.com/apache/hertzbeat.git开发工具使用的IDEA项目运行run/debug和项目构建mvn命令使用的maven版本可不一致。因此可能出现项目运行成功但是项目构建失败比如执行clean、compile、package、install等插件命令失败。2.项目运行IDEA中maven配置File-setting-maven进行maven配置如图BundledMaven 3表示使用IDEA默认安装的maven版本如3.9.9Use Maven Wrapper表示使用项目中指定的maven版本项目拉取中有.mvn文件夹会指定需要的maven版本会下载使用也可指定自定义安装的maven版本。执行run/debug时使用的此处的maven配置。项目中设置maven版本和jdk版本可正常运行项目。3.环境变量配置这里说的项目构建指的通过mvn命令执行插件命令此时的maven版本和jdk版本使用的是环境变量配置的版本可以看出此时使用的是maven3.5.4jdk8。按照项目要求版本不符合要求因此会构建失败。设置jdk环境变量windows中设置jdk8和jdk17环境变量按照项目要求设置java_home。设置maven环境变量windows中设置maven3.5.4和maven3.9.11环境变量按照项目要求设置maven_home。4.项目构建将maven的环境变量设置为3.9.11jdk的环境变量设置为jdk17后执行mvn clean install -DskipTests命令成功。至此项目构建成功推荐按照项目的总体要求设置maven和jdk的环境变量然后构建项目运行项目