IntelliJ识别Maven模块依赖仍报‘package不存在’编译错误的原因？

我之前也碰到过一模一样的情况——IDE里代码提示正常、手动运行测试也没问题，但一用Maven命令行构建就报找不到包的错误。核心原因很明确：你在IntelliJ里手动添加的模块依赖只是IDE层面的本地配置，并没有同步到Maven的pom.xml构建逻辑里，Maven本身完全不知道playground模块需要依赖core模块。

解决方案：在playground的pom.xml中显式声明core模块依赖 #

打开playground模块的pom.xml，在<dependencies>节点中添加对core模块的依赖配置：

<dependencies>
    <!-- 保留原有其他依赖 -->
    <dependency>
        <groupId>com.gene</groupId>
        <artifactId>genetest1-core</artifactId>
        <version>${project.version}</version>
        <!-- 因为仅在测试代码中使用core的工具类，用test scope足够，避免不必要的依赖传递 -->
        <scope>test</scope>
    </dependency>
</dependencies>

这里用${project.version}是因为子模块已经继承了父pom的版本，不用手动写死版本号，后续父版本变更时子模块依赖会自动同步。

验证构建效果 #

添加完依赖后，执行以下Maven命令：

mvn clean test

先执行clean清理之前的编译缓存，再执行test阶段——Maven会先构建core模块，再用core的编译结果去构建playground的测试代码，就能彻底解决“package does not exist”的错误了。

补充说明 #

IntelliJ的模块依赖设置（File > Project Structure > Modules）只是用来优化IDE的代码分析和本地运行体验，完全不影响Maven的命令行构建逻辑。Maven的构建完全依赖pom.xml中的配置，任何依赖关系都必须在pom里声明，IDE的手动配置只是“辅助优化”，不能替代pom的核心配置。你之前做的Invalidate Caches和修改JDK Importer都是IDE层面的操作，当然解决不了Maven本身的依赖配置问题啦。

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