添加Dagger Hilt后AppCompatActivity相关报错求助

1. 对齐Hilt依赖与AndroidX版本兼容性 #

保证Hilt依赖和项目的AndroidX库版本匹配，尤其是appcompat库，避免版本不兼容导致的类识别异常。在模块级build.gradle中配置：

// Hilt核心依赖
implementation "com.google.dagger:hilt-android:2.48"
kapt "com.google.dagger:hilt-android-compiler:2.48"
// 同步兼容的appcompat版本
implementation "androidx.appcompat:appcompat:1.6.1"

2. 修正Activity的Hilt注解使用 #

所有接入Hilt的Activity必须在类上方添加@AndroidEntryPoint注解，确保注解位置正确且继承关系清晰：

import androidx.appcompat.app.AppCompatActivity;
import dagger.hilt.android.AndroidEntryPoint;

@AndroidEntryPoint
public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}

@AndroidEntryPoint会生成代理类，若注解位置错误，IDE会误判父类类型，引发清单和方法重写的提示问题。

3. 简化清单文件的Activity声明 #

清单中无需手动指定父类，保持默认声明即可，多余的配置会干扰IDE的类识别：

<activity
    android:name=".MainActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

4. 清理缓存并重建项目 #

这类IDE误判大多源于缓存问题，执行以下操作：

• 点击Build -> Clean Project
• 点击Build -> Rebuild Project
• 重启Android Studio并清除缓存：File -> Invalidate Caches... -> 勾选Invalidate and Restart

5. 检查Hilt插件配置 #

确保项目级build.gradle中添加了Hilt插件依赖：

plugins {
    id 'com.android.application' version '7.4.2' apply false
    id 'com.google.dagger.hilt.android' version '2.48' apply false
}

模块级build.gradle中应用插件：

plugins {
    id 'com.android.application'
    id 'dagger.hilt.android.plugin'
}

6. 确认AndroidX全局配置 #

项目根目录的gradle.properties必须开启AndroidX：

android.useAndroidX=true
android.enableJetifier=true

如果以上操作后问题仍存在，可通过./gradlew app:dependencies命令查看依赖树，排查是否有旧support库与AndroidX库共存的冲突，排除冲突的support依赖即可。

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