如何向.m2仓库添加pom.xml无法自动获取的插件与依赖？

为什么手动丢jar到.m2仓库没用？ #

Maven本地仓库有严格的分层目录规则（groupId/artifactId/version层级），且仅放jar包不够——还需要对应版本的pom文件、校验文件（如.sha1），Maven才能识别该依赖/插件的完整信息。随便丢到plugin目录自然无法被识别。

方法1：让Maven自动下载（优先推荐） #

1. 确认pom.xml配置正确
   插件必须放在<build><plugins>块内，以properties-maven-plugin为例，完整配置示例：

   <build>
     <plugins>
       <plugin>
         <groupId>org.codehaus.mojo</groupId>
         <artifactId>properties-maven-plugin</artifactId>
         <version>1.1.0</version>
         <!-- 可选：绑定插件执行目标，比如读取属性文件 -->
         <executions>
           <execution>
             <phase>initialize</phase>
             <goals>
               <goal>read-project-properties</goal>
             </goals>
             <configuration>
               <files>
                 <file>src/main/resources/project.properties</file>
               </files>
             </configuration>
           </execution>
         </executions>
       </plugin>
     </plugins>
   </build>
   

2. 强制Maven更新拉取
   执行命令：

   mvn clean install -U
   

   -U参数会强制Maven更新远程仓库元数据，确保拉取最新的依赖/插件信息。
3. 检查远程仓库配置
   确认settings.xml中启用了Maven中央仓库（或公司私有仓库），默认中央仓库配置如下：

   <repositories>
     <repository>
       <id>central</id>
       <url>https://repo1.maven.org/maven2</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>false</enabled>
       </snapshots>
     </repository>
   </repositories>
   <pluginRepositories>
     <pluginRepository>
       <id>central</id>
       <url>https://repo1.maven.org/maven2</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>false</enabled>
       </snapshots>
     </pluginRepository>
   </pluginRepositories>
   

方法2：手动正确放置到本地仓库（无网络时用） #

1. 创建符合规则的目录
   在.m2/repository下创建路径：org/codehaus/mojo/properties-maven-plugin/1.1.0
2. 放置文件
   • 将下载的jar包重命名为properties-maven-plugin-1.1.0.jar，放入上述目录
   • 新增properties-maven-plugin-1.1.0.pom文件，核心内容需匹配groupId、artifactId、version，示例：

     <?xml version="1.0" encoding="UTF-8"?>
     <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <modelVersion>4.0.0</modelVersion>
       <groupId>org.codehaus.mojo</groupId>
       <artifactId>properties-maven-plugin</artifactId>
       <version>1.1.0</version>
       <name>Properties Maven Plugin</name>
       <description>Properties Plugin for Maven. This plugin provides goals to read properties from files and URLs.</description>
     </project>
     

   • 可选：若有对应的.sha1/.md5校验文件，也一并放入目录，避免Maven校验失败。

方法3：清理缓存后重新导入 #

1. 删除.m2/repository中对应插件/依赖的目录（比如org/codehaus/mojo/properties-maven-plugin）
2. 执行mvn clean install让Maven重新拉取
3. 在IDE中重新导入Maven项目：比如IntelliJ点击右侧Maven面板的「Reload All Maven Projects」，Eclipse右键项目→Maven→Update Project

通用排查要点 #

• 检查groupId、artifactId、version的拼写、大小写是否完全正确，任何错误都会导致找不到
• 区分插件和依赖的配置位置：插件放<build><plugins>，依赖放<dependencies>
• 确认网络可访问远程仓库，或配置了正确的代理/私有仓库权限

内容的提问来源于stack exchange，提问作者1029Coder