Maven安装与配置&错误解决

最新推荐文章于 2025-04-09 18:48:58 发布

QiuL_Hash

最新推荐文章于 2025-04-09 18:48:58 发布

阅读量3.9k

点赞数 6

分类专栏： Java 文章标签： java spring

本文链接：https://blog.youkuaiyun.com/ql1053927633/article/details/105640476

版权

Java 专栏收录该内容

1 篇文章

订阅专栏

Maven安装与配置

下载与安装

下载地址：https://maven.apache.org/download.cgi
文件解压到D:\Program Files\Apache\maven目录
新建环境变量MAVEN_HOME，赋值D:\Program Files\Apache\maven
编辑环境变量Path，追加%MAVEN_HOME%\bin\;
maven完成安装，打开DOS输入mvn -v检查环境变量是否配置成功。

配置Maven本地仓库

在解压目录下新建maven-repository文件夹，用作maven的本地库
打开.\conf\settings.xml文件，将localRepository节点所在行复制出注释，并修改为maven-repository所在的路径。该节点用于配置本地仓库，起缓存作用，默认地址为C:\Users\用户名.m2。当我们从maven中获取jar包的时候，maven首先会在本地仓库中查找，如果本地仓库有则返回；如果没有则从远程仓库中获取包，并在本地库中保存。
在maven项目中运行mvn install，项目将会自动打包并安装到本地仓库中。
DOS运行mvn help:system，如果前面的配置成功，那么D:\Program Files\Apache\maven-repository会出现一些文件。

配置Eclipse的Maven环境

Eclipse Oxygen，打开Window->Preferences->Maven->Installations，右侧点击Add设置maven的安装目录installation home：D:\Program Files\Apache\maven和installation name ：maven，然后Finish。选中添加的maven，并Apply。
打开Window->Preferences->Maven->User Settings，配置User Settings（open file）点击Browse选中D:\Program Files\Apache\maven\conf\settings.xml如下并Apply：
Maven的安装和配置全部结束。

配置IDEA的Maven环境

打开IntelliJ IDEA->file->Settings->Build,Execution,Deployment->Build Tools->Maven配置Maven。
选择maven文件夹Maven home directory：D:\Program Files\Apache\maven
选择修改过的配置文件User settings file：D:\Program Files\Apache\maven\conf\settings.xml
自动检测到本地仓库路径Local repository：D:\Program Files\Apache\maven-repository

使用IntelliJ IDEA 配置Maven：https://www.cnblogs.com/telwanggs/p/10820701.html
Maven安装与配置：https://www.cnblogs.com/eagle6688/p/7838224.html

Maven安装与配置

一、需要准备的东西

JDK
Eclipse
Maven程序包

二、下载与安装

前往https://maven.apache.org/download.cgi下载最新版的Maven程序：

在这里插入图片描述

将文件解压到D:\Program Files\Apache\maven目录下:

在这里插入图片描述

新建环境变量MAVEN_HOME，赋值D:\Program Files\Apache\maven

在这里插入图片描述

编辑环境变量Path，追加%MAVEN_HOME%\bin;

在这里插入图片描述

至此，maven已经完成了安装，我们可以通过DOS命令检查一下我们是否安装成功：

mvn -v
在这里插入图片描述

三、配置Maven本地仓库

在D:\Program Files\Apache\目录下新建maven-repository文件夹，该目录用作maven的本地库。
打开D:\Program Files\Apache\maven\conf\settings.xml文件，查找下面这行代码：

<localRepository>/path/to/local/repo</localRepository>

localRepository节点默认是被注释掉的，需要把它移到注释之外，然后将localRepository节点的值改为我们在3.1中创建的目录D:\Program Files\Apache\maven-repository。

localRepository节点用于配置本地仓库，本地仓库其实起到了一个缓存的作用，它的默认地址是 C:\Users\用户名.m2。

当我们从maven中获取jar包的时候，maven首先会在本地仓库中查找，如果本地仓库有则返回；如果没有则从远程仓库中获取包，并在本地库中保存。

此外，我们在maven项目中运行mvn install，项目将会自动打包并安装到本地仓库中。

运行一下DOS命令

mvn help:system
如果前面的配置成功，那么D:\Program Files\Apache\maven-repository会出现一些文件。

四、配置Eclipse的Maven环境

Eclipse Oxygen，打开Window->Preferences->Maven->Installations，右侧点击Add。

在这里插入图片描述

设置maven的安装目录，然后Finish

在这里插入图片描述

选中刚刚添加的maven，并Apply。
打开Window->Preferences->Maven->User Settings，配置如下并Apply：

至此，Maven的安装和配置全部结束。

IDEA Unable to import maven project: See logs for details （maven的坑）

系统重装之后，Idea的配置是之前就认为没什么问题，就没去过多注意，但是后来发现建SpringBoot项目默认的版本太高，pom.xml每次都会报错，因为是maven本地库没有相应的包，我就手动设置一下版本，混过过去就算了，没想花太多时间去解决。但是后来新增的依赖就不行了，完全自动不会下载，没办法只能解决。我就开始各种怀疑，idea联网是否正常，maven的Setting.xml有没有设置好，alibaba镜像是不是挂了，还是破解Idea的副作用。

 废话扯完了，下面进入正题：

经过一堆无用的挣扎之后，我留意到右下角的Evnet Log，报的错误：Unable to import maven project: See logs for details

于是我就按照提示打开了日志，Help>>show Log in Explorer
在这里插入图片描述

你就会发现一堆错误，异常，警告

我的问题主要有两个：

没有权限在C盘中下载文件
无法获取获取目标资源（镜像是国外的，网络有时候连不上）

在这里插入图片描述

解决办法：

 将repository放到非C盘中（直接改权限貌似也不行），将镜像源换成国内的。

找到对应maven的setting.xml，在mirrors中增加

<mirror>
  <id>alimaven</id>
  <name>aliyun maven</name>
  <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
  <mirrorOf>central</mirrorOf>        
</mirror>

还有一些注意的地方，idea是由缓存的，你修改好之后，最好清一下缓存以及重启。

还一个地方也会有影响，idea的settings>>build,execution,Deployment>>Build Tools>>Maven>>importing的 JDK for importer 设置问题，我的默认设置是jre，但是jre不满足我们需要，所以要设置为jdk才好。
在这里插入图片描述

Idea maven 工具窗口详解

在这里插入图片描述

maven仓库中的LastUpdated文件处理

背景：
最近在公司使用maven从公司私库更新依赖时，发现很多依赖更新失败，检查本地maven仓库文件，发现更新失败的依赖文件夹中都生成了lastUpdated后缀结尾的文件，通过网上搜索资料以及自己实践现记录下解决方式。

网络上分析问题原因及解决方式：
1、因为多种原因(网速慢、断网)导致jar包下载不下来或者下载不完整，出现很多.lastUpdated文件
解决方式：
第一步：先删除maven仓库中以.lastUpdated后缀的文件，可以通过命令删除：
Windows环境，先在cmd命令行中进入到maven仓库文件下，执行命令： for /r %i in (*.lastUpdated) do del %i
Linux环境，可执行命令：find /app/maven/localRepository -name "*.lastUpdated" -exec grep -q "Could not transfer" {} \; -print -exec rm {} \;
第二步：idea环境，在pom文件，右键项目 -》下拉找到Maven -》选择Reimport即可。建议在从新导入之前，先取私库中检查一下，该依赖是否存在。
尝试了这种方式，发现还是不行，所以继续看
2、配置问题，很迷，检查idea的maven配置，是否使用我们配置的maven，setting.xml文件配置
解决方式：开始检查idea的maven配置没有问题，发现配置也是对的，然后检查maven的setting文件中配置的镜像地址也是对的没有问题，尝试将本地依赖全部删除再更新也还是这样。最后，发现在setting.xml中配置了两个镜像，一个阿里云，一个私库，所以尝试将阿里云的镜像注释，然后更新。发现更新成功。猜测是maven更新的时候，从阿里云上下载依赖了。
以上就是排查的过程。

项目使用maven管理jar包，很容易因为各种原因(网速慢、断网)导致jar包下载不下来，出现很多.lastUpdated文件。这些文件一个一个删除太麻烦。下面是全部删除的方法

windows系统

cd %userprofile%\.m2\repository
for /r %i in (*.lastUpdated) do del %i

linux系统

find /app/maven/localRepository -name "*.lastUpdated" -exec grep -q "Could not transfer" {} \; -print -exec rm {} \;
find /app/mujup/maven/localRepository -name "*.lastUpdated" -exec grep -q "Could not transfer" {} \; -print -exec rm {} \;

http://archive.apache.org/dist/maven/maven-3/3.5.0/binaries/
https://blog.youkuaiyun.com/oschina_41661541/article/details/90297215

IDEA maven 库更换阿里云镜像
东西下载慢，一靠翻墙，二换镜像，没别的

墙已经翻过了，不好使，找找镜像吧

在网上翻到一个阿里云的镜像，更换步骤如下：

右键项目选择 maven 选项，然后选择 open settings.xml 或者 create settings.xml

顺便说说这个 setting.xml，刚安装的 IDEA 是没有这个文件的，每次新建项目的时候会让你选择这个配置文件，默认位置在 C:\Users\UserName\.m2\settings.xml，当然你也可以更换，具体在 File -> Settings -> maven 更换。

也就是说，在 C:\Users\UserName\.m2\settings.xml 配置的相当于是全局的，如果要为单个项目配置需要更换 settings.xml。这段话别太纠结，就是顺嘴提一句，跟本文没有一丁点关系，请手动忽略。

复制下面的代码替换 setting.xml 里的内容，重启 IDEA

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <mirrors>
        <mirror>
            <id>alimaven</id>
            <name>aliyun maven</name>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
            <mirrorOf>central</mirrorOf>
        </mirror>

        <mirror>
            <id>uk</id>
            <mirrorOf>central</mirrorOf>
            <name>Human Readable Name for this Mirror.</name>
            <url>http://uk.maven.org/maven2/</url>
        </mirror>

        <mirror>
            <id>CN</id>
            <name>OSChina Central</name>
            <url>http://maven.oschina.net/content/groups/public/</url>
            <mirrorOf>central</mirrorOf>
        </mirror>

        <mirror>
            <id>nexus</id>
            <name>internal nexus repository</name>
            <url>http://repo.maven.apache.org/maven2</url>
            <mirrorOf>central</mirrorOf>
        </mirror>

    </mirrors>
</settings>

搞定，下载速度飞起~

https://www.cnblogs.com/wangpengpeng/p/7444027.html

https://www.cnblogs.com/jocelynjuan5677/p/10703147.html

IDEA Error:java: Compilation failed: internal java compiler error

解决办法很简单：File-->Setting...-->Build,Execution,Deployment-->Compiler-->Java Compiler 设置相应Module的target bytecode version的合适版本（跟你jkd版本一致），这里我改成1.8版本的。

https://www.cnblogs.com/dpl9963/p/10075456.html

怎么配置Maven的本地仓库

第一步:
打开自己安装Maven的文件夹

第二步：
打开安装包内的 conf 文件夹

第三步：
找到Maven的配置文件settings.xml，并打开（用IDEA或者Edit打开都可以）

第四步：
找到 localRepository（本地仓库）标签在后面加入
“你存放Maven本地仓库的磁盘路径"
1

第五步
配置阿里镜像（为了防止你本地仓库中没有jar包时可以快速自动下载jar包，默认是在外域官网处下载的，下载速度较慢，这里一般使用国内的阿里的中央仓库）
同样在shetting.xml配置文件中找到 < mirrors > 标签，在后面加上

<mirror>
	<id>alimaven</id>
	<name>aliyun maven</name>
	<url>
		http://maven.aliyun.com/nexus/content/groups/public/
	</url>
	<mirrorOf>central</mirrorOf>
 </mirror>

这里也准备了Maven本地仓库的下载：

第一种：
直接解压到本地仓库:百度网盘提取码：oq54

第二种：
去阿里的中央仓库下载：https://mvnrepository.com/

https://blog.youkuaiyun.com/China_HaoZi/article/details/105289942

https://www.cnblogs.com/jingmoxukong/p/6050172.html?utm_source=gold_browser_extension

史上最全的maven pom.xml文件教程详解
https://blog.youkuaiyun.com/yaerfeng/article/details/26448417

idea maven下载jar包失败解决办法

相信大家在idea 中使用maven中导入依赖,而本地仓库没有,需要从远程仓库下载时,都会遇到过下载失败,在maven repository中残留.lastUpdated文件.
如何解决,并修复这些下载不完整的jar包依赖呢?
首先点击右侧maven栏
在这里插入图片描述
点击m图标

在Command line中输入 mvn -U idea:idea

然后重新加载下

在这里插入图片描述

解决idea中maven项目的pom文件不会自动下载jar包问题 + 更新不完整依赖命令

不会自动下载jar包 idea昨天还在正常使用，结果今天发现pom文件中的依赖不会自动下载了，最后百度找到了解决方案：
setting ——> maven ——> 去掉work offline 的勾，问题解决！
在这里插入图片描述
但是我之前用着还是没有这个问题的, 百度发现可能是Intellij idea setting显示出错/或者电脑运行过久出错，在经历几次重启 Intellij idea 和Invalidate caches/Restart之后，发现work offline 的勾被选中。