Android Studio传递依赖版本冲突致API识别异常的解决问询

问题核心 #

项目编译时Gradle会自动选择依赖的最高版本（如androidx.fragment:1.3.6），但Android Studio的索引系统错误地优先加载了Play Services传递过来的旧版本依赖（androidx.fragment:1.0.0），导致API标红、代码补全失效，但编译实际能正常运行。

可行修复方案 #

1. 显式声明高版本依赖，强制覆盖传递依赖

在app模块的build.gradle（或build.gradle.kts）中，直接声明你需要的高版本androidx.activity、androidx.fragment和androidx.core依赖，让IDE和编译环境统一使用这些版本：

dependencies {
    // 强制指定高版本，覆盖所有传递依赖的旧版本
    implementation 'androidx.activity:activity:1.5.1'
    implementation 'androidx.fragment:fragment:1.3.6'
    implementation 'androidx.core:core:1.7.0' // 选择与appcompat兼容的高版本
    
    // 原有依赖
    implementation 'androidx.appcompat:appcompat:1.5.1'
    implementation project(':mylibrary')
}

2. 彻底排除旧版本传递依赖

如果显式声明还没解决问题，在引入mylibrary时，排除Play Services传递过来的旧版AndroidX依赖：

implementation project(':mylibrary') {
    exclude group: 'androidx.fragment', module: 'fragment'
    exclude group: 'androidx.core', module: 'core'
    exclude group: 'androidx.activity', module: 'activity'
}

你也可以在mylibrary模块的build.gradle中，对Play Services依赖做同样的排除，避免传递到上层模块：

dependencies {
    implementation 'com.google.android.gms:play-services-base:18.1.0' {
        exclude group: 'androidx.fragment', module: 'fragment'
        exclude group: 'androidx.core', module: 'core'
        exclude group: 'androidx.activity', module: 'activity'
    }
    implementation 'com.google.android.gms:play-services-auth:20.4.0' {
        exclude group: 'androidx.fragment', module: 'fragment'
        exclude group: 'androidx.core', module: 'core'
        exclude group: 'androidx.activity', module: 'activity'
    }
}

3. 清理Android Studio缓存并重启

IDE缓存可能残留了旧的依赖索引，导致标红问题：

• 点击顶部菜单栏 File -> Invalidate Caches...
• 勾选Invalidate and Restart，等待IDE重启后重新同步Gradle项目

4. 验证依赖解析结果

运行Gradle命令查看依赖树，确认最终使用的版本是否符合预期：

# macOS/Linux
./gradlew app:dependencies

# Windows
gradlew.bat app:dependencies

在输出中查找androidx.fragment:fragment、androidx.activity:activity和androidx.core:core，确认显示的是你指定的高版本。

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