Android Studio Lint无法识别AppCompatActivity为FragmentActivity子类

问题场景 #

我的Activity继承自AppCompatActivity：

class MainActivity : AppCompatActivity() {

在代码中调用FragmentActivity的成员（比如invalidateMenu()、onBackPressedDispatcher）时，编译和运行完全正常，但Android Studio的Lint持续报错，提示无法找到这些成员。所有继承AppCompatActivity的Activity都存在这个问题。

关键细节 #

• 按住Ctrl点击AppCompatActivity，跳转至Gradle缓存中androidx.core:core:1.0.0下的ComponentActivity，代码为：

public class ComponentActivity extends Activity
        implements LifecycleOwner, KeyEventDispatcher.Component { 

• 按住Ctrl点击强制转换后的onBackPressedDispatcher，跳转至Gradle缓存中androidx.activity:activity:1.7.1下的ComponentActivity，代码为：

public class ComponentActivity extends androidx.core.app.ComponentActivity implements
        ContextAware,
        LifecycleOwner,
        ViewModelStoreOwner,
        HasDefaultViewModelProviderFactory,
        SavedStateRegistryOwner,
        OnBackPressedDispatcherOwner,
        ActivityResultRegistryOwner,
        ActivityResultCaller,
        OnConfigurationChangedProvider,
        OnTrimMemoryProvider,
        OnNewIntentProvider,
        OnMultiWindowModeChangedProvider,
        OnPictureInPictureModeChangedProvider,
        MenuHost,
        FullyDrawnReporterOwner {

同时存在未解决状态、强制转换后解决状态的代码截图，以及Problems窗口的报错显示。

问题原因 #

这是AndroidX依赖版本冲突导致的类不一致问题：

• AppCompatActivity的继承链依赖旧版本androidx.core:core中的ComponentActivity，该类仅继承自Activity，未包含onBackPressedDispatcher等成员。
• onBackPressedDispatcher等成员来自新版本androidx.activity:activity中的ComponentActivity，该类继承自androidx.core.app.ComponentActivity并实现了相关接口。
• Lint无法识别两个ComponentActivity的继承关系，因此误报成员不存在。

解决方案 #

1. 统一AndroidX Activity相关依赖版本 #

在项目级build.gradle中统一指定依赖版本，确保androidx.activity和androidx.appcompat版本匹配：

ext {
    activityVersion = "1.7.1"
    appcompatVersion = "1.6.1" // 选择与activity版本兼容的appcompat版本
}

在模块级build.gradle中使用统一版本：

implementation "androidx.activity:activity:$activityVersion"
implementation "androidx.appcompat:appcompat:$appcompatVersion"

2. 清理Gradle缓存与IDE缓存 #

• 执行Gradle命令清理并刷新依赖：

  ./gradlew clean build --refresh-dependencies
  

• 删除本地Gradle缓存目录：
  • Windows：C:\Users\<你的用户名>\.gradle\caches
  • Mac/Linux：~/.gradle/caches
• 重启Android Studio，执行File -> Invalidate Caches... -> Invalidate and Restart

3. 排查并排除冲突依赖 #

运行依赖树命令查看冲突的旧版本依赖：

./gradlew app:dependencies

找到引用旧版本androidx.core:core的依赖，在对应的implementation中排除：

implementation("冲突的依赖包") {
    exclude group: 'androidx.core', module: 'core'
}

4. 临时Workaround（不推荐长期使用） #

如果暂时无法调整依赖，可以通过强制转换消除Lint报错：

// 调用invalidateMenu()
(this as FragmentActivity).invalidateMenu()

// 使用onBackPressedDispatcher
(this as ComponentActivity).onBackPressedDispatcher.onBackPressed()

内容的提问来源于stack exchange，提问作者Doron Ben-Ari