离线环境下修复Maven插件无法识别问题

1. 核查本地仓库插件的完整性 #

Maven核心插件（如install、dependency）对应本地仓库的路径为org/apache/maven/plugins/[插件名]，需确认：

• 目标插件的版本目录（如maven-install-plugin/3.1.1）存在
• 版本目录下包含完整文件：[插件名]-[版本].jar、[插件名]-[版本].pom，以及对应的.sha1/.md5校验文件（缺失的话从联网机器下载后传输）
• 文件名无拼写错误，比如不要将pom文件误命名为pom.xml（Maven默认识别不带.xml后缀的pom文件）

2. 检查settings.xml配置正确性 #

• 确认<localRepository>节点指向你的本地仓库实际路径，示例：

  <localRepository>/opt/maven-local-repo</localRepository>
  

• 配置离线模式，避免Maven尝试联网，在settings.xml中添加以下内容：

  <mirrors>
    <mirror>
      <id>local-only</id>
      <mirrorOf>central</mirrorOf>
      <url>file:///opt/maven-local-repo</url>
    </mirror>
  </mirrors>
  <profiles>
    <profile>
      <id>offline-profile</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <repositories>
        <repository>
          <id>central</id>
          <url>file:///opt/maven-local-repo</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>false</enabled></snapshots>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>central</id>
          <url>file:///opt/maven-local-repo</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>false</enabled></snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>
  

3. 手动指定插件版本执行命令 #

若Maven无法自动匹配插件版本，直接在命令中明确版本号，示例：

mvn org.apache.maven.plugins:maven-install-plugin:3.1.1:help

版本号可从联网机器查询对应插件的稳定版本，确保本地仓库已存在该版本文件。

4. 删除本地仓库缓存文件 #

清理仓库中记录远程信息的_remote.repositories缓存文件，避免干扰离线识别：

• Linux/macOS可执行批量删除命令：

  find /opt/maven-local-repo -name "_remote.repositories" -delete
  

• Windows可手动搜索并删除所有该类型文件

5. 验证插件POM文件有效性 #

打开插件版本目录下的pom文件，检查是否存在XML格式错误（如标签未闭合、依赖路径错误），若文件损坏，从联网机器重新下载对应版本的POM文件替换。

内容的提问来源于stack exchange，提问作者Oliver Harris