Eclipse未使用项目本地Maven仓库，如何配置多本地仓库？

一、先修正你之前的仓库配置误区 #

你在pom.xml中配置的<repositories>是Maven的依赖搜索仓库列表，可以包含本地目录作为仓库，但要确保配置格式正确：

<repositories>
    <repository>
        <id>project-local-repo</id>
        <name>Project Local Repository</name>
        <!-- 用Maven内置变量指向项目根目录的本地仓库，避免硬编码路径 -->
        <url>file://${project.basedir}/local-maven-repo</url>
    </repository>
</repositories>

同时，部署外部Jar到该仓库的命令必须匹配依赖的groupId/artifactId/version：

mvn install:install-file -Dfile=/path/to/your.jar -DgroupId=com.your.group -DartifactId=your-artifact -Dversion=1.0.0 -Dpackaging=jar -DlocalRepositoryPath=${project.basedir}/local-maven-repo

二、让Eclipse识别自定义本地仓库 #

1. 强制刷新Maven项目：右键项目 → Maven → Update Project，勾选Force Update of Snapshots/Releases后点击OK。这会让Eclipse重新读取pom.xml的仓库配置，去指定的local-maven-repo中查找依赖。
2. Eclipse全局仓库设置不影响多仓库搜索：打开Window → Preferences → Maven → User Settings，这里的localRepository是全局默认本地仓库，但Maven会同时搜索全局仓库和pom.xml中配置的所有仓库（包括本地目录仓库），不存在“只能配置一个本地仓库”的限制。

三、排查常见失效原因 #

• 检查local-maven-repo的目录结构：必须遵循Maven仓库规范，即反向groupId路径/artifactId/version/，比如com/example/testjar/1.0/testjar-1.0.jar，同时要有对应的.pom文件。
• 核对依赖配置：pom.xml中依赖的groupId/artifactId/version必须和部署Jar时的参数完全一致，大小写、符号都不能错。
• 清理缓存：执行Project → Clean清理项目，再重新Update Maven Project。

四、全局配置多本地仓库（可选） #

如果需要让所有项目都能访问多个本地仓库，可在Maven的settings.xml（默认路径~/.m2/settings.xml）中添加如下配置：

<profiles>
    <profile>
        <id>multiple-local-repos</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <repositories>
            <repository>
                <id>global-local-repo</id>
                <url>file:///path/to/your/global/repo</url>
            </repository>
            <repository>
                <id>project-local-repo</id>
                <url>file:///path/to/your/project/repo</url>
            </repository>
        </repositories>
    </profile>
</profiles>

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