Maven多模块构建报错：batch-module无法找到web-module包

1. 确认模块构建顺序 #

Maven多模块构建遵循依赖优先级，但如果父模块的<modules>节点顺序不合理，或存在循环依赖，会导致batch-module构建时web-module还未生成可依赖的包：

• 检查父模块pom的<modules>，确保web-module在batch-module之前声明：

  <modules>
    <module>web-module</module>
    <module>batch-module</module>
  </modules>
  

• 排查是否存在循环依赖：比如web-module的pom里也引入了batch-module，这种情况会直接导致构建失败。

2. 检查web-module的打包类型 #

如果web-module是war打包类型，默认Maven只会生成war包，不会将编译后的类单独发布到本地仓库，这会导致依赖它的模块找不到类文件：

• 方案一：修改web-module的打包类型为jar（如果该模块不需要作为web应用部署）：

  <packaging>jar</packaging>
  

• 方案二：保留war打包，配置maven-war-plugin将类打包成jar并附加到仓库：
  在web-module的pom中添加：

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>3.3.2</version>
        <configuration>
          <attachClasses>true</attachClasses>
          <classesClassifier>classes</classesClassifier>
        </configuration>
      </plugin>
    </plugins>
  </build>
  

  同时在batch-module的依赖中指定classifier：

  <dependency>
    <groupId>你的项目groupId</groupId>
    <artifactId>web-module</artifactId>
    <version>项目版本号</version>
    <classifier>classes</classifier>
  </dependency>
  

3. 核对依赖参数的准确性 #

确保batch-module中依赖web-module的groupId、artifactId、version与web-module pom中的定义完全一致，包括大小写、版本号（如果使用父模块统一管理版本，要确认变量引用正确）。

4. 清理本地Maven仓库缓存 #

本地仓库中web-module的缓存包可能损坏或不完整，导致构建时无法读取：

• 执行命令强制更新并重新构建：mvn clean install -U
• 手动删除本地仓库中对应web-module的目录（路径一般为~/.m2/repository/你的groupId/web-module），再重新执行构建。

5. 检查web-module的代码目录结构 #

确认web-module的业务类、实体类都放在src/main/java目录下，而非src/test/java——Maven构建时只会打包src/main/java下的代码到产物中。

6. 统一IDE与命令行的Maven环境 #

IntelliJ可能使用内置Maven或自定义配置，和命令行环境不一致导致差异：

• 打开IntelliJ设置：File → Settings → Build, Execution, Deployment → Build Tools → Maven，确认Maven home directory与命令行执行mvn -v显示的版本一致。

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