使用自定义Jar编译Maven项目时出现编译错误

这是IDE依赖管理和Maven依赖体系脱节导致的典型问题——IDE里通过Build Path添加外部jar能正常编译，但Maven构建时完全不认这些手动添加的依赖，因为两者的依赖配置是两套独立的体系。下面给你两种解决方案，优先推荐第一种：

方案1：利用已安装到本地Maven仓库的项目1依赖（最优解） #

你已经对项目1执行了mvn clean compile package install，这个命令其实已经把项目1的jar包安装到了你的本地Maven仓库（默认路径是用户目录下的.m2/repository）。完全不需要手动导出jar再添加外部依赖，直接在项目2的pom.xml中配置项目1的依赖即可：

• 打开项目2的pom.xml文件
• 在<dependencies>标签内添加项目1的依赖配置，确保groupId、artifactId、version和项目1的pom.xml完全一致：

<dependency>
    <groupId>com.yourcompany.ccfix</groupId> <!-- 替换成项目1的实际groupId -->
    <artifactId>ccfix</artifactId> <!-- 替换成项目1的实际artifactId -->
    <version>1.0.0</version> <!-- 替换成项目1的实际版本号 -->
</dependency>

• 保存pom.xml后，执行mvn clean compile，Maven会自动从本地仓库加载项目1的依赖，编译错误就会消失
• 最后记得把项目2中手动添加的ccfix.jar从Build Path里移除，避免依赖冲突

方案2：手动引入外部jar（仅临时场景使用） #

如果因为特殊原因无法使用Maven仓库依赖，你可以把ccfix.jar作为本地系统依赖让Maven识别：

1. 在项目2的根目录创建一个lib文件夹，将ccfix.jar复制到该文件夹中
2. 在项目2的pom.xml中添加以下依赖配置：

<dependencies>
    <dependency>
        <groupId>com.example.ccfix</groupId> <!-- 自定义一个groupId -->
        <artifactId>ccfix</artifactId>
        <version>1.0.0</version> <!-- 自定义版本号 -->
        <scope>system</scope>
        <systemPath>${project.basedir}/lib/ccfix.jar</systemPath>
    </dependency>
</dependencies>

注意：system scope的依赖存在局限性，比如无法传递给其他依赖项目，部署时可能需要额外处理，所以仅在临时场景使用。

核心原因总结 #

IDE（比如Eclipse/IntelliJ）的Build Path是本地IDE的单独配置，而Maven构建完全基于pom.xml中的依赖定义。你手动添加的外部jar不在Maven的依赖列表里，所以Maven编译时自然找不到对应的类。用Maven的依赖管理体系统一配置，就能解决这个脱节问题。

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