Maven（IntelliJ）始终拉取远程构件，如何使用本地构建的jar？

问题场景 #

我有两个存在依赖关系的Maven项目，分别为common和service，其中service依赖common下的common-module模块。更新common-module后执行mvn clean install，该模块已成功安装到本地Maven仓库，但在service项目中执行mvn clean package/install或mvn -U clean package/install时，始终拉取远程仓库中的版本，而非本地刚构建的更新版本，即使能在.m2/repository中看到本地版本。

配置信息 #

common的pom.xml（已简化） #

<?xml version="1.0" encoding="UTF-8"?>  
<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"  
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">  
    <artifactId>common-parent</artifactId>  
    <version>2.4.5-SNAPSHOT</version>  
    <name>Common Parent</name>  
    <modules>  
        <module>common-module</module>  
    </modules>
</project>

common-module的pom.xml（已简化） #

<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">  
    <artifactId>common-module</artifactId>  
    <name>common-module</name>  
    <description>common-module</description>  
    <parent>  
        <artifactId>common-parent</artifactId>  
        <groupId>com.company.group</groupId>  
        <version>2.4.5-SNAPSHOT</version>  
    </parent>
</project>

service的pom.xml（已简化） #

<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
    xmlns="http://maven.apache.org/POM/4.0.0"  
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">  
    <artifactId>service</artifactId>  
    <name>service</name>  
    <version>1.2.3-SNAPSHOT</version>
    <dependencies>
        <dependency>  
            <artifactId>common-module</artifactId>  
            <groupId>com.company.group</groupId>  
            <version>2.4.5-SNAPSHOT</version>  
        </dependency>
    </dependencies>
</project>

补充说明 #

• 临时解决方案：在IntelliJ中调整库设置强制使用正确的jar包，但方法繁琐且不可持续。
• 已尝试修改settings.xml中的<updatePolicy>值为never及其他值，但无效果：

<repository>
    <id>snapshots</id>
    <name>Archiva Managed Snapshot Repository</name>
    <url>http://internal.url/repository/snapshots</url>
    <releases>
        <enabled>false</enabled>
    </releases>
    <snapshots>
        <enabled>true</enabled>
        <updatePolicy>never</updatePolicy>
    </snapshots>
</repository>

解决方案 #

1. 检查本地快照版本的时间戳 #

Maven快照版本会生成带时间戳的实际jar文件（例如common-module-2.4.5-20240520.123456-1.jar），如果远程仓库的快照版本时间戳比本地新，Maven会优先拉取远程版本。

• 进入本地仓库目录~/.m2/repository/com/company/group/common-module/2.4.5-SNAPSHOT，查看本地生成的jar文件的时间戳
• 删除该目录下的所有文件，重新执行mvn clean install安装common-module，确保本地版本的时间戳是最新的

2. 离线模式构建service #

执行构建命令时添加-o参数，强制Maven使用离线模式，只依赖本地仓库的依赖，不会去远程拉取更新：

mvn -o clean install

3. 调整仓库优先级与配置 #

• 检查settings.xml中是否有镜像配置覆盖了快照仓库，导致Maven优先访问远程镜像而非本地仓库
• 确保本地仓库在仓库列表中的优先级最高，可在service的pom.xml中显式声明本地仓库：

<repositories>
    <repository>
        <id>local-repo</id>
        <url>file://${user.home}/.m2/repository</url>
        <releases><enabled>true</enabled></releases>
        <snapshots><enabled>true</enabled></snapshots>
    </repository>
    <repository>
        <id>snapshots</id>
        <name>Archiva Managed Snapshot Repository</name>
        <url>http://internal.url/repository/snapshots</url>
        <releases><enabled>false</enabled></releases>
        <snapshots><enabled>true</enabled></snapshots>
    </repository>
</repositories>

4. 使用Maven reactor统一构建 #

如果common和service可以放在同一目录结构下，创建一个父pom来管理两个模块，Maven会自动按依赖顺序构建：

<?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>com.company.group</groupId>
    <artifactId>parent-project</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <packaging>pom</packaging>
    <modules>
        <module>../common</module> <!-- 根据实际路径调整 -->
        <module>../service</module>
    </modules>
</project>

在父项目目录执行mvn clean install，即可自动构建common-module并让service直接使用本地构建的版本。

5. 调整IntelliJ的Maven配置（IDE构建场景） #

• 打开IntelliJ的Settings → Build, Execution, Deployment → Build Tools → Maven
• 取消勾选"Always update snapshots"选项，避免IDE自动拉取远程快照
• 确保IDE使用的是本地的Maven配置文件（settings.xml），而非内置配置

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