KMM androidMain源集无法引用其他模块commonMain类IDE报错问题

你没有遗漏配置，对KMM依赖机制的理解完全正确，该问题属于Kotlin Multiplatform IDE支持插件的已知bug，和你的项目配置无关。

配置正确性说明 #

KMM源集依赖默认遵循传递继承规则：

• androidMain源集默认隐式依赖commonMain，你在commonMain中声明的:shared模块依赖，会自动被androidMain、iosMain等所有平台源集继承
• 这也是为什么代码可以正常编译、部署运行——Gradle构建阶段的依赖解析逻辑完全正常，不存在依赖缺失的问题
• 不需要额外在androidMain的依赖块中重复声明:shared依赖，重复声明属于无效冗余配置

问题根因 #

该异常来自IDE的索引逻辑缺陷，和构建逻辑无关：

1. 当依赖在多平台模块的common源集之间跨模块传递时，IDE的代码静态分析引擎没有正确识别到依赖的传递关系，错误判定当前源集无权访问目标类，因此抛出未解析引用的错误提示
2. 提示框中「添加依赖」按钮点击无反应也是该bug的典型表现：IDE本身已经识别到依赖存在，只是索引环节出错，因此不会执行任何配置修改操作
3. 手动添加import语句后错误消失，本质是显式import给IDE提供了明确的类路径，强制IDE索引到目标类，绕过了依赖关系校验的异常逻辑，不代表之前缺少配置。

临时缓解方案 #

目前Jetbrains还在持续修复这类多模块KMM项目的索引问题，你可以通过以下方式降低问题出现概率：

• 升级到最新稳定版的Kotlin插件、Android Studio/IntelliJ IDEA，近几个版本已经修复了大量同类跨模块依赖索引异常
• 遇到错误提示时优先执行File > Invalidate Caches...，勾选清除文件系统缓存和索引后重启IDE，多数场景下可以恢复正常的代码识别
• 如果不想清理缓存，直接手动添加对应类的import即可，不会对最终编译产物造成任何影响
• 使用Kotlin 1.8及以上版本，开启默认的层级源集配置，不要手动自定义过时的源集依赖结构，可以大幅减少这类问题的触发概率

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