导入他人开发的Maven项目时maven-shade-plugin:3.2.4下载失败求助

错误原因 #

Maven之前尝试下载org.apache.maven.plugins:maven-shade-plugin:3.2.4时失败，失败信息被缓存到本地仓库，默认情况下Maven不会重新尝试下载，直到缓存过期或者触发强制更新。

解决方案 #

1. 强制更新依赖 #

在项目根目录打开终端，执行以下命令：

mvn clean install -U

-U参数会强制Maven忽略本地缓存，重新从远程仓库下载所有依赖和插件。

2. 手动清理本地缓存 #

如果强制更新无效，手动删除本地仓库中该插件的缓存文件：

• 找到本地Maven仓库路径（默认是~/.m2/repository（Linux/macOS）或C:\Users\你的用户名\.m2\repository（Windows））
• 进入路径org/apache/maven/plugins/maven-shade-plugin/3.2.4
• 删除该目录下的所有文件（尤其是.lastUpdated结尾的缓存文件）
• 回到项目根目录执行mvn clean install重新构建

3. IDE内强制重新导入 #

如果使用IDE（如IntelliJ IDEA、Eclipse）导入项目：

• IntelliJ IDEA：右键项目 → Maven → Reload Project，勾选「Force Update of Snapshots/Releases」选项
• Eclipse：右键项目 → Maven → Update Project，勾选「Force Update of Snapshots/Releases」

4. 配置国内镜像（可选） #

如果网络访问中央仓库不稳定，可配置国内Maven镜像：
在Maven的settings.xml文件（路径为Maven安装目录/conf/settings.xml或~/.m2/settings.xml）的<mirrors>标签中添加：

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>central</mirrorOf>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

配置完成后重新执行构建或导入操作。

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