Maven编译含依赖JAR文件的Java类失败问题排查

你碰到的问题很典型——Maven默认不会自动把src/main/lib目录下的JAR文件纳入编译类路径，这个目录并不是Maven标准的依赖存放位置，Maven默认依赖都是从本地或远程仓库拉取的，本地自定义目录的JAR需要手动配置才能被识别。

下面给你几种可行的解决办法，按推荐程度排序：

1. 最规范：把本地JAR安装到本地Maven仓库 #

这是Maven推荐的做法，能让你的本地JAR像普通依赖一样被管理，步骤如下：

• 打开终端，执行安装命令（替换成你的JAR文件名、groupId、artifactId和版本）：

  mvn install:install-file -Dfile=src/main/lib/你的依赖.jar -DgroupId=com.yourgroup -DartifactId=your-lib -Dversion=1.0 -Dpackaging=jar
  

• 然后在你的pom.xml里添加对应的依赖节点：

  <dependency>
      <groupId>com.yourgroup</groupId>
      <artifactId>your-lib</artifactId>
      <version>1.0</version>
  </dependency>
  

之后再执行mvn clean install，编译应该就能正常通过了。

2. 直接配置pom.xml识别本地目录JAR（不推荐长期用） #

如果不想把JAR安装到仓库，可以通过配置让Maven直接读取src/main/lib的文件：

方式A：使用system scope依赖 #

在pom.xml里为每个本地JAR添加依赖，指定systemPath：

<dependency>
    <groupId>com.yourgroup</groupId>
    <artifactId>your-local-lib</artifactId>
    <version>1.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/src/main/lib/你的依赖.jar</systemPath>
</dependency>

⚠️ 注意：system scope的依赖不会自动被打包到最终JAR里，如果需要打包，还要额外配置maven-assembly-plugin或maven-shade-plugin。

方式B：配置本地仓库目录 #

在pom.xml里添加一个指向src/main/lib的本地仓库：

<repositories>
    <repository>
        <id>local-lib-repo</id>
        <url>file://${project.basedir}/src/main/lib</url>
    </repository>
</repositories>

不过这种方式要求你的JAR文件必须符合Maven仓库的目录结构（即groupId/artifactId/version/xxx.jar），如果你的JAR不是这种结构，需要先调整目录，不然Maven找不到对应的依赖。

最后，建议先执行mvn clean compile测试编译是否正常，没问题再执行mvn clean install。

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