Maven Shade Plugin 传输失败解决方法

本文旨在帮助开发者解决在使用 Maven 构建项目时，由于 maven-shade-plugin 无法从 Maven 中央仓库下载而导致的构建失败问题。我们将探讨可能的原因，并提供一系列解决方案，包括检查网络连接、清理本地仓库、更新插件版本以及正确配置插件等。通过本文，你将能够顺利解决该问题，确保项目构建的顺利进行。

常见原因及解决方案

当 Maven 尝试下载 org.apache.maven.plugins:maven-shade-plugin 及其依赖项时失败，通常会抛出类似 "failed to transfer from <中央仓库地址>" 的错误。 这个问题可能由多种原因引起，以下是几种常见的解决方案：

1. 检查网络连接

最基本但经常被忽略的一点是检查你的网络连接是否正常。确保你可以访问互联网，并且没有防火墙或代理阻止 Maven 访问 Maven 中央仓库。

2. 清理本地 Maven 仓库

Maven 会将下载的依赖项缓存在本地仓库中。如果本地仓库中的某些文件损坏或不完整，可能会导致下载失败。你可以尝试清理本地仓库，强制 Maven 重新下载依赖项。

• 找到本地仓库位置: 默认情况下，本地仓库位于 ~/.m2/repository 目录下。你也可以在 Maven 的 settings.xml 文件中找到 <localRepository> 标签来确定本地仓库的位置。
• 删除相关依赖项: 删除本地仓库中与 maven-shade-plugin 相关的目录。例如，删除 ~/.m2/repository/org/apache/maven/plugins/maven-shade-plugin 目录。
• 重新构建项目: 使用 mvn clean install 命令重新构建项目，Maven 将会尝试重新下载依赖项。

3. 强制更新 Maven 依赖

有时候，Maven 会因为缓存策略而不会主动更新依赖项。你可以使用 -U 参数强制 Maven 检查并更新依赖项。

mvn clean install -U

4. 检查和更新 maven-shade-plugin 版本

确保你使用的 maven-shade-plugin 版本是最新的稳定版本。旧版本可能存在 bug 或与其他依赖项不兼容。你可以在 pom.xml 文件中修改插件的版本号。

例如，将 maven-shade-plugin 的版本更新到 3.4.1 或更高版本：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.4.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>core.Main</mainClass>
                    </transformer>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

注意： 确保 <configuration> 标签位于 <executions> 标签内部的 <execution> 标签中。

5. 检查 Maven 仓库配置

如果你的项目使用了私有 Maven 仓库，或者需要通过代理访问 Maven 中央仓库，请确保你的 settings.xml 文件配置正确。

• 配置代理: 如果需要通过代理访问互联网，请在 settings.xml 文件中配置 <proxies> 标签。
• 配置镜像: 如果使用了 Maven 镜像，请在 settings.xml 文件中配置 <mirrors> 标签。

6. 检查依赖冲突

有时候，依赖冲突也会导致下载失败。你可以使用 mvn dependency:tree 命令查看项目的依赖树，找出可能存在的冲突，并尝试解决它们。

总结

解决 maven-shade-plugin 传输失败问题需要仔细检查各个环节。 按照上述步骤，逐一排查网络连接、本地仓库、插件版本、Maven 仓库配置以及依赖冲突等问题，通常可以找到问题的根源并解决它。 在更新插件版本或修改配置后，建议先执行 mvn clean 命令清理项目，然后再重新构建。