Gradle多模块依赖问题：同时引入A、B模块仅一个可被Intellij识别

云原生阿岚

2026-9-30

问题原因及解决方案

该问题本质是IntelliJ IDEA的Gradle项目解析异常，因为命令行Gradle构建可以正常完成，说明依赖配置本身没有语法错误，问题出在IDEA的索引或模块同步逻辑上。以下是按出现概率从高到低排列的原因及对应解决方法：

本地缓存/索引损坏
这是IDEA最常见的依赖识别异常原因，解决方式很简单：点击顶部菜单栏 File -> Invalidate Caches...，勾选「Clear file system cache and local history」，重启IDEA后等待Gradle重新同步、索引重建完成即可。
子模块命名冲突
你的A、B的API子模块路径都是xxx:api，IDEA默认导入时如果没有配置单独的模块命名规则，会将两个模块的名称都识别为api，导致后加载的B-api模块直接覆盖A-api的索引。
排查&解决：打开 File -> Project Structure -> Modules 检查模块列表：
1. 如果列表中不存在:A:api对应的模块，或者两个api模块名称重复，可修改根目录settings.gradle为两个api子模块指定唯一的模块名
2. 打开 Settings -> Build, Execution, Deployment -> Build Tools -> Gradle，勾选「Create separate module per source set」后重新同步Gradle
内部插件兼容问题
你用到的公司内部mycompany.api-conventions插件如果内置了IDEA模块的自定义配置规则，可能存在多API模块同时导入时的解析bug。
临时解决：在C模块的build.gradle中强制声明A-api的依赖优先级，添加如下配置后重新同步Gradle：
```
configurations.implementation {
    resolutionStrategy.force project(":A:api")
}
```
全限定类名冲突
如果A、B的API模块存在完全相同的全限定类名，IDEA索引会优先关联依赖顺序靠后的模块，可能导致前序模块的同包下所有类识别异常。
解决：排查两个API模块的包名、类名是否有重复，修改重复的类/包名即可。