解决 Maven 报错: maven-clean-plugin 无法解析

搞定 Maven 报错："maven-clean-plugin:2.5 or one of its dependencies could not be resolved"

碰上 Maven 构建报错 maven-clean-plugin:2.5 or one of its dependencies could not be resolved，真是让人头大。别慌，咱一步步来分析，解决它！

问题现象

从 Subversion 下载项目后，在 IntelliJ IDEA 里用 Maven 构建时，控制台输出类似下面的错误：

[ERROR] Plugin org.apache.maven.plugins:maven-clean-plugin:2.5 or one of its dependencies could not be resolved: Cannot access central (https://repo.maven.apache.org/maven2) in offline mode and the artifact org.apache.maven.plugins:maven-clean-plugin:jar:2.5 has not been downloaded from it before. -> [Help 1]

从报错信息看，问题出在 maven-clean-plugin 这个插件上，Maven 无法解析这个插件或者它的依赖。

原因分析

造成这个问题的原因可能有以下几种：

1. 网络问题: 你的电脑可能无法访问 Maven 中央仓库 (https://repo.maven.apache.org/maven2)。可能是网络配置问题，也可能是被墙了。

2. Maven 离线模式: Maven 可能处于离线模式 (offline mode)，导致无法从远程仓库下载插件。

3. 本地仓库损坏: Maven 本地仓库 (.m2/repository) 中的文件可能损坏或者不完整。

4. 代理设置问题: 如果你使用了代理服务器，Maven 的代理配置可能有误。

5. Maven 或插件版本问题: 虽然不常见，但理论上也有可能是 Maven 本身或者 maven-clean-plugin 插件存在 bug。

6. settings.xml 配置问题 : settings.xml文件中可能包含不正确的配置。

解决方案

针对以上可能的原因，我们可以尝试以下解决方案：

1. 检查网络连接

最简单的，先看看能不能正常上网，ping 一下 repo.maven.apache.org，看看能不能通。

ping repo.maven.apache.org

如果 ping 不通，检查一下你的网络设置，或者尝试使用 VPN 等工具。

2. 关闭 Maven 离线模式

如果你确定网络没问题，那很可能是 Maven 开启了离线模式。有几种方式可以关闭离线模式：

• IntelliJ IDEA 设置: 在 IntelliJ IDEA 中，找到 Maven 设置（File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven），确保 "Offline work " 这个选项没有被勾选。

• 命令行参数: 如果你是通过命令行运行 Maven 命令，检查一下是否使用了 -o 或 --offline 参数，如果有，去掉它。

• 全局设置: 检查 Maven 的全局配置文件 (通常是 ~/.m2/settings.xml 或者 Maven 安装目录下的 conf/settings.xml)，看看 <offline> 元素是否被设置为 true，如果是，改成 false 或者直接删除这个元素。

3. 清理并重建本地仓库

本地仓库损坏也挺常见的。简单粗暴的方法就是删除整个 .m2/repository 目录，然后让 Maven 重新下载所有依赖。不过，这样会比较慢，你也可以选择只删除 maven-clean-plugin 相关的目录：

# 删除整个本地仓库 (谨慎操作！)
rm -rf ~/.m2/repository

# 或者只删除 maven-clean-plugin 相关的目录
rm -rf ~/.m2/repository/org/apache/maven/plugins/maven-clean-plugin

删除后，重新构建项目，Maven 会自动下载所需的依赖。

4. 检查和配置代理

如果你使用了代理服务器，确保 Maven 的代理设置正确。在 Maven 的 settings.xml 文件中，找到 <proxies> 元素，配置你的代理服务器信息：

<proxies>
  <proxy>
    <id>my-proxy</id>
    <active>true</active>
    <protocol>http</protocol>
    <host>your.proxy.host</host>
    <port>your.proxy.port</port>
    <username>your.username</username>  
    <password>your.password</password>
    <!-- <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts> --> 
  </proxy>
</proxies>

配置好后,保存,重新运行Maven。

5. 检查 settings.xml 配置文件

有时，settings.xml 文件中的错误配置也可能导致这个问题。检查 settings.xml 文件中是否有拼写错误、不正确的仓库配置、或者不兼容的插件配置等。

着重观察mirror配置:

 <mirrors>
    <!-- mirror
     | Specifies a repository mirror site to use instead of a given repository. The
     | repository that this mirror serves has an ID that matches the mirrorOf element
     | of this mirror. IDs are used for inheritance and direct lookup purposes, and
     | must be unique across the set of mirrors.
     |
    <mirror>
      <id>mirrorId</id>
      <mirrorOf>repositoryId</mirrorOf>
      <name>Human Readable Name for this Mirror.</name>
      <url>http://my.repository.com/repo/path</url>
    </mirror>
     -->
  </mirrors>

保证 mirrorOf 与 repositoryId 对应无误.

6. 指定插件版本（备选方案）

通常 Maven 会自动下载最新版本的插件，但如果最新版本有问题，你可以尝试指定一个较旧的、稳定的版本。在项目的 pom.xml 文件中，找到 build -> plugins 部分，显式指定 maven-clean-plugin 的版本：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-clean-plugin</artifactId>
      <version>2.4.1</version> 
      </plugin>
    ...
  </plugins>
</build>

不一定非要是2.4.1, 根据实际情况调整, 可以到maven中心仓库查找稳定版.

7. 使用 dependency:tree 命令分析依赖 (进阶)

Maven 的 dependency:tree 命令可以帮助你查看项目的依赖树，这有助于分析依赖冲突或者缺失的问题。

mvn dependency:tree -Dverbose

从结果里边找和 clean 相关的部分看看, 是不是少东西, 哪个依赖没拉下来之类的。

8. 更新 Maven（备选方案）

如果你用的 Maven 版本太旧了，可以考虑升级到最新版本。

安全建议

• 不要随意删除 .m2/repository ：虽然这是个解决问题的办法，但删除整个本地仓库意味着你要重新下载所有依赖，耗时耗力。尽量先尝试其他方法，确定问题出在本地仓库，再考虑删除。
• 谨慎配置代理： 如果你在公司内网或者需要使用代理，一定要仔细核对代理服务器的信息，避免配置错误导致安全问题。
• 定期清理: 虽然不建议频繁删除整个, 但是过多的历史依赖会导致 .m2 过于庞大, 可以考虑适度清理

希望以上这些方法能帮到你。遇到问题不要怕，多尝试，总能解决的！