IntelliJ+jgitver-maven-plugin多模块下无法找到接口实现的解决办法

环境与项目结构 #

• IntelliJ IDEA 2022.2.1
• jgitver-maven-plugin 1.9.0
  多模块Maven结构：

parent
  |____ spec
  |       |____MyInterface.java
  |
  |____ impl
          |____MyInterfaceImpl.java

问题现象 #

• 命令行Maven构建完全正常，但在IntelliJ中右键MyInterface选择「Go to -> Implementations」时，提示「No implementations found」
• 在MyInterfaceImpl类中Ctrl+ClickMyInterface时，会打开Maven仓库中反编译的NumberResource.class，而非项目内的接口文件
• 已尝试添加-Djgitver.skip参数构建，无效；移除jgitver插件后功能恢复正常

解决方案1：配置IntelliJ使用jgitver扁平模式 #

1. 打开IntelliJ设置（Windows/Linux：File -> Settings；Mac：IntelliJ IDEA -> Settings）
2. 导航到「Build, Execution, Deployment -> Build Tools -> Maven -> Runner」
3. 在「VM Options」中添加参数：-Djgitver.mode=flat

   扁平模式会让jgitver避免修改模块版本坐标，防止IntelliJ的模块依赖映射混乱

4. 点击「Apply」→「OK」，然后执行「Maven -> Reload All Maven Projects」

解决方案2：让jgitver仅在命令行构建时生效 #

在父模块pom.xml中修改插件配置，让它跳过IntelliJ自动构建阶段，仅在命令行执行特定目标时运行：

<plugin>
    <groupId>fr.brouillard.oss</groupId>
    <artifactId>jgitver-maven-plugin</artifactId>
    <version>1.9.0</version>
    <executions>
        <execution>
            <id>version</id>
            <phase>validate</phase>
            <goals>
                <goal>version</goal>
            </goals>
            <configuration>
                <skip>${maven.execution.id != 'default-cli'}</skip>
            </configuration>
        </execution>
    </executions>
</plugin>

修改后，IntelliJ自动构建会跳过jgitver，命令行执行mvn package/mvn deploy等命令时插件仍正常工作。

解决方案3：手动修正IntelliJ模块依赖映射 #

1. 打开「Project Structure」（快捷键Ctrl+Alt+Shift+S）
2. 进入「Modules」，选中impl模块
3. 在「Dependencies」标签页中，找到对spec的依赖，确认其「Scope」为compile，且指向项目内的spec模块而非Maven仓库依赖
4. 若依赖指向仓库，点击右侧「Edit」，选择「Module Dependency」并指定项目内的spec模块
5. 点击「Apply」→「OK」，然后执行「Build -> Clean Project」和「Build -> Rebuild Project」

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