如何在IntelliJ中使用Maven本地common模块并切换至.m2依赖？

项目配置 #

• parent-pom：依赖common模块
• service-pom：
  • 是parent-pom的子模块
  • 配置了common的更新清理规则，确保始终使用最新版本

遇到的问题 #

模块导入IntelliJ后，common依赖默认取自本地.m2仓库，导致：

• 无法进行跨模块重构、类内代码新增操作
• 缺失代码自动补全功能

尝试过的方案及问题：

1. 修改项目结构，将本地common模块添加为service的依赖并置于.m2仓库依赖之上：
   • 解决了自动补全和重构问题，但版本切换易混淆，且Spring Boot编译启动失败（在common类中新增字段并在service中引用时，编译报错找不到该字段）
2. 配置包含common的工件，添加运行配置并启用resolve workspace artifacts：未达预期效果
3. 将本地common模块加入parent-pom模块，再将parent-pom模块添加至service，并为parent-pom配置工件：问题仍未解决

需求：实现编译启动service时优先使用本地common模块，且可按需切换至.m2仓库版本

1. 修正Maven多模块结构配置 #

先确保项目是标准Maven多模块目录结构：

root-project/
├── parent-pom/
│   └── pom.xml
├── common/
│   └── pom.xml
└── service/
    └── pom.xml

• 在parent-pom/pom.xml中，将common和service声明为子模块：

  <modules>
      <module>../common</module>
      <module>../service</module>
  </modules>
  

• 在service/pom.xml中，使用模块依赖替代仓库依赖：

  <dependencies>
      <dependency>
          <groupId>你的项目groupId</groupId>
          <artifactId>common</artifactId>
          <version>${project.version}</version>
          <scope>compile</scope>
      </dependency>
  </dependencies>
  

此配置会让Maven优先加载本地common模块代码，而非.m2仓库中的jar包。

2. IntelliJ中配置模块关联 #

• 打开File > Project Structure > Modules
• 移除service中指向.m2仓库的common依赖，仅保留指向本地common模块的依赖项
• 点击Apply保存配置

3. 按需切换版本的两种方式 #

临时切换（单次构建/运行） #

在IntelliJ的Maven工具栏执行构建命令时，添加强制使用仓库依赖的参数：

mvn clean install -Dmaven.dependency.useRepository=true

此命令会让Maven临时跳过本地模块，从.m2仓库拉取common版本。

持久化切换（长期使用仓库版本） #

修改service/pom.xml中的common依赖，指定仓库中的具体版本号：

<dependencies>
    <dependency>
        <groupId>你的项目groupId</groupId>
        <artifactId>common</artifactId>
        <version>1.0.0.RELEASE</version> <!-- 替换为仓库中实际版本 -->
        <scope>compile</scope>
    </dependency>
</dependencies>

修改后点击IntelliJ右侧Maven面板的Reload All Maven Projects，即可切换为仓库版本。若要切回本地模块，改回${project.version}并重新导入Maven项目即可。

4. 解决Spring Boot编译启动报错 #

使用本地common模块时，先执行common模块的mvn clean install，将最新代码同步到本地仓库（但service仍会优先使用本地模块源码，而非仓库jar包）。

同时，在Spring Boot运行配置中，将Build and run using设置为IntelliJ IDEA，确保IDE直接使用本地模块的编译结果，而非依赖仓库jar包。

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