Maven无法识别本地仓库已存在依赖引发项目构建报类不存在错误
提问内容
这类Maven构建时提示“包不存在”的报错是技术社区的高频问题,我尝试过网上流传的多种通用解决方案,始终没能解决自己遇到的问题。
我有两个关联的Maven项目:
- 被依赖的基础项目InfoFinder,坐标如下:
<groupId>com.mycompany.InfoFinder</groupId> <artifactId>InfoFinder</artifactId> <version>1.0.6.4</version>
- 依赖InfoFinder的业务项目updates,坐标如下:
<groupId>com.mycompany.update</groupId> <artifactId>updates</artifactId> <version>1.0.44.8</version> <dependencies> <dependency> <groupId>com.mycompany.InfoFinder</groupId> <artifactId>InfoFinder</artifactId> <version>1.0.6.4</version> </dependency> </dependencies>
在updates项目目录下执行 mvn clean install -U 时,出现如下编译报错:
.../src/main/java/com/mycompany/Update.java:[3,48] package com.mycompany.companyInfo does not exist .../src/main/java/eu/com/mycompany/Update.java:[51,36] cannot find symbol....
报错提示找不到的包全部来自InfoFinder项目的代码。在Eclipse环境中,我可以正常点击跳转打开InfoFinder中对应的类文件。如果将updates对InfoFinder的依赖切换为旧版本,构建流程可以正常运行。
我已经尝试过的排查操作:
- 本地
.m2仓库路径下可以看到InfoFinder对应版本的依赖文件夹,删除该文件夹后重新拉取依赖,问题没有改善 - 尝试执行
dependency:purge-local-repository clean install命令清理本地缓存,问题依旧存在 - 在Eclipse环境中对所有Maven项目执行更新、对Java项目执行清理重置,问题仍然没有解决
- 以往遇到这类报错,通常重复几次构建就会自行消失,但这次多次重复构建也无法解决
目前确认的问题线索:
- 两个项目在Eclipse中都可以正常构建、运行,问题肯定出在Maven命令行构建环节
- 使用旧版本InfoFinder依赖时Maven不会报错,问题根源出在InfoFinder本身的构建流程上
补充说明
我是先成功构建完成InfoFinder项目,再对updates项目执行构建操作,报错是在updates的构建阶段出现的。两个项目的完整POM配置如下:
InfoFinder(项目A)POM
<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.mycompany.InfoFinder</groupId> <artifactId>InfoFinder</artifactId> <version>1.0.6.4</version> <build> <pluginManagement> <plugins> <plugin> <artifactId>maven-compiler-plugin</artifactId> <version>3.3</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-deploy-plugin</artifactId> <version>2.8.2</version> </plugin> </plugins> </pluginManagement> </build> <distributionManagement> <repository> ... </repository> <snapshotRepository> ... </snapshotRepository> </distributionManagement> <dependencies> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> <version>4.5</version> </dependency> <dependency> <groupId>com.mycompany.AgeCalculator</groupId> <artifactId>AgeCalculator</artifactId> <version>1.0.3</version> </dependency> <dependency> <groupId>eu.linkedbusiness.tool.selenium.imports</groupId> <artifactId>seleniumImports</artifactId> <version>1.0.3-RELEASE</version> </dependency> <dependency> <groupId>com.mycompany.solver</groupId> <artifactId>solver</artifactId> <version>[1,)</version> </dependency> </dependencies> </project>
updates(项目B)POM
<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.mycompany.update</groupId> <artifactId>updates</artifactId> <version>1.0.44.8</version> <repositories> <repository> <releases> <enabled>false</enabled> <updatePolicy>always</updatePolicy> <checksumPolicy>warn</checksumPolicy> </releases> <snapshots> <enabled>true</enabled> <updatePolicy>never</updatePolicy> <checksumPolicy>fail</checksumPolicy> </snapshots> <layout>default</layout> </repository> <repository> <releases> <enabled>true</enabled> <updatePolicy>always</updatePolicy> <checksumPolicy>warn</checksum> </releases> <snapshots> <enabled>false</enabled> <updatePolicy>never</updatePolicy> <checksumPolicy>fail</checksum> </snapshots> <name>Nexus RELEASE</name> <layout>default</layout> </repository> </repositories> <dependencies> <dependency> <groupId>org.jsoup</groupId> <artifactId>jsoup</artifactId> <version>1.13.1</version> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> </dependency> <dependency> <groupId>com.mycompany.Calculator</groupId> <artifactId>Calculator</artifactId> <version>LATEST</version> </dependency> <dependency> <groupId>com.mycompany.ExtraMetadata</groupId> <artifactId>ExtraMetadata</artifactId> <version>LATEST</version> </dependency> <dependency> <groupId>com.mycompany.InfoFinder</groupId> <artifactId>InfoFinder</artifactId> <version>1.0.6.4</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>jcl-over-slf4j</artifactId> <version>1.7.6</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.7.6</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>1.7.6</version> </dependency> </dependencies> <build> <plugins> <plugin> <artifactId>maven-assembly-plugin</artifactId> <configuration> <archive> <manifest> <mainClass>....Main</mainClass> </manifest> </archive> <descriptorRefs> <descriptorRef>jar-with-dependencies</descriptorRef> </descriptorRefs> </configuration> <executions> <execution> <id>make-assembly</id> <phase>package</phase> <goals> <goal>single</goal> </goals> </execution> </executions> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-deploy-plugin</artifactId> <version>2.8.2</version> </plugin> </plugins> </build> <distributionManagement> <snapshotRepository>.... </snapshotRepository> <repository>... </repository> </distributionManagement> </project>
排查结论与解决步骤
核心问题定位
出现IDE正常、命令行构建报错的反差,本质是本地仓库中InfoFinder 1.0.6.4版本的Jar包本身不包含缺失的类文件,和本地缓存脏污没有关系。Eclipse读取类时是直接指向工作空间的源码路径,并不会校验本地仓库Jar包的完整性,因此才会出现跳转正常但构建失败的错觉。
根因(结合POM配置定位)
- 插件配置位置错误导致InfoFinder打Jar流程异常
InfoFinder的POM中,maven-compiler-plugin的编译配置全部写在了<pluginManagement>标签内。这个标签仅适用于多模块项目的父POM,作用是给子模块提供通用的插件配置模板,对当前项目本身的构建流程不会生效。
没有实际绑定插件配置的情况下,Maven会使用内置的老旧版本compiler插件执行编译,很容易出现编译中断但流程未报错的情况,最终打出的Jar包会缺失部分类文件。 - 动态版本范围依赖导致构建不稳定
InfoFinder中对solver的依赖配置为<version>[1,)</version>,这类无边界的版本范围会让每次构建都拉取仓库中最新的匹配版本,如果拉取的依赖存在兼容问题,会直接打断InfoFinder的编译流程,打出残缺的Jar包。
操作步骤
- 先验证判断:打开本地
.m2仓库中com/mycompany/InfoFinder/1.0.6.4/InfoFinder-1.0.6.4.jar,用解压工具检查是否存在com/mycompany/companyInfo路径下的class文件,大概率会发现该路径完全缺失。 - 修正InfoFinder的POM配置:将maven-compiler-plugin从
<pluginManagement>节点移到<build><plugins>节点下,让编译配置对当前项目生效,写法参考:
<build> <plugins> <plugin> <artifactId>maven-compiler-plugin</artifactId> <version>3.3</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> </plugins> </build>
- 将InfoFinder中solver依赖的动态版本范围替换为固定版本,避免每次构建拉取不同版本的依赖导致编译结果随机。
- 重新在InfoFinder目录下执行
mvn clean install,构建完成后再次解压本地仓库的Jar包,确认缺失的类已经被正确打包,再对updates项目执行构建。 - 额外优化:updates项目中多个依赖使用
LATEST版本标识,这类写法会导致构建结果随机不稳定,建议全部替换为固定版本号,避免后续出现类似的无规律报错。
内容的提问来源于stack exchange,提问作者Skaros Ilias
相关产品推荐
相关产品推荐

