Maven编译失败（包不存在）：Eclipse引用库依赖机制疑问

一、Maven编译时的依赖查找路径 #

Maven执行package等编译相关目标时，只会从以下固定来源查找依赖，完全不识别Eclipse手动添加的引用库或项目依赖：

• 本地Maven仓库（默认路径~/.m2/repository）：所有通过mvn install安装的本地项目、或从远程仓库下载的依赖都存储在此。
• 配置的远程仓库（如Maven中央仓库、公司私有仓库）：本地仓库缺失的依赖会从这里拉取。
• 仅通过pom.xml显式声明的依赖（包括直接依赖、传递依赖）。

Eclipse的「Required project」「引用库」是IDE层面的配置，只会写入Eclipse的.classpath文件，和Maven的依赖体系完全独立。

二、Eclipse无错但Maven编译失败的核心原因 #

Eclipse和Maven用的是两套完全独立的构建逻辑：

• Eclipse依赖自身的JDT编译器，读取.classpath配置（包括你手动添加的A.jar），所以能找到A的类，无错误提示；
• Maven依赖javac编译器，严格按照pom.xml里<dependencies>节点声明的依赖解析类路径，找不到未声明的A，因此编译报错。

三、Maven对「手动添加引用库」的处理逻辑 #

结论很明确：Maven根本不处理Eclipse手动添加的引用库。它的依赖解析遵循「约定大于配置」原则，所有编译、打包时需要的类，必须通过以下方式之一声明：

1. 在pom.xml的<dependencies>里添加依赖坐标（本地仓库或远程仓库存在对应包）；
2. 通过<dependency>的systemPath属性指定本地Jar的绝对/相对路径（不推荐，破坏依赖可移植性）；
3. 自定义Maven插件（如maven-compiler-plugin）配置额外类路径，手动引入Jar。

你之前手动添加的A.jar，只是Eclipse的本地IDE配置，完全不会被Maven的构建生命周期（clean、compile、package等）识别。

四、同事相同配置能构建的可能原因 #

大概率是同事的本地环境存在你没注意到的隐性差异：

• 同事曾执行过mvn install将A安装到本地仓库，即使B的pom没声明依赖，Maven可能通过本地仓库的快照包或隐式传递依赖找到A（这属于不规范的场景）；
• 同事的Eclipse安装了自动同步IDE引用库到pom.xml的插件；
• 同事的项目有自定义Maven插件配置，手动指定了A.jar的类路径。

内容的提问来源于stack exchange，提问作者Gaetan L.