Android Studio单元测试引用src/main类标红 补全失效运行正常

问题核心特征 #

• 单元测试存放于app/src/test/java路径，通过命令行Gradle、Android Studio内置测试运行器均可正常执行，用例通过/失败逻辑符合预期，test目录下类、方法互相调用无异常
• IDE编辑环境中，test目录下代码引用src/main目录下生产代码类时，相关类、方法全部标红，自动补全失效，无法跳转至对应声明位置
• IDE给出的快速修复提示为"add dependency on module xxx"，执行后会添加implementation project(path: ':app')配置，该修复为错误提示，绝对不要执行，添加后会触发循环依赖导致构建失败

排查解决步骤（按操作成本从低到高排序） #

• 清理IDE缓存重建索引：点击菜单栏 File > Invalidate Caches...，弹窗中勾选Clear file system cache and Local History、Clear VCS Log caches and indexes选项，点击Invalidate and Restart，等待重启后索引完全重建再验证问题是否消失。80%以上的同类问题都是缓存损坏导致的，这一步优先操作。
• 核对Gradle源集配置：打开app模块的build.gradle/build.gradle.kts文件，检查是否存在手动覆盖test源集的错误配置，比如使用全量赋值修改srcDirs的写法会覆盖默认的源集依赖关联，示例错误配置如下：

// 错误配置，会破坏test与main目录的类路径映射
sourceSets {
    test {
        java {
            srcDirs = ['src/test/java']
        }
    }
}

如果存在这类配置，将=改为+=做增量添加即可，不要直接覆盖默认的源集配置项。

• 关闭存在兼容bug的实验性开关：Android Studio Chipmunk版本对test类路径分离开关存在兼容bug，检查gradle.properties和模块build.gradle中是否存在android.enableUnitTestBinaryResources=true、android.experimental.enableSeparateTestClasspath=true这类配置，存在的话直接删除或改为false，之后同步Gradle即可。
• 重置项目IDE配置：如果以上操作都无效，关闭Android Studio，删除项目根目录下的.idea文件夹、所有模块的.iml文件、项目根目录的.gradle缓存文件夹，重新打开项目等待全量同步和索引完成即可。

问题原因说明 #

这类「代码能跑但IDE标红」的问题，本质是IDE编辑态的索引映射逻辑和Gradle实际构建逻辑不一致导致的：测试运行时走Gradle真实的类路径配置，所以执行完全正常；但编辑时的补全、跳转、错误提示走的是IDE预先生成的索引表，一旦索引因为缓存损坏、配置被错误覆盖、版本兼容bug出现映射错配，就会出现这类假报错。

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