Android Hilt混淆配置问题：开启minifyEnabled后应用崩溃解决方案

要在开启minifyEnabled true的同时正常使用Hilt，核心是确保Hilt运行时依赖的类、自动生成的代码以及你自定义的Hilt注解类不被混淆。以下是具体解决步骤：

1. 确认Hilt依赖配置正确 #

确保你的app模块build.gradle中引入了正确的Hilt依赖（请替换为当前最新稳定版本）：

implementation "com.google.dagger:hilt-android:2.48"
kapt "com.google.dagger:hilt-android-compiler:2.48"

Hilt的aar包默认包含consumerProguardFiles，会自动引入基础混淆规则，但如果你的项目有自定义混淆文件，仍需补充关键规则。

2. 添加Hilt专属混淆规则 #

在项目的proguard-rules.pro文件中添加以下规则，避免Hilt核心类、生成代码被混淆：

# 保留Hilt核心类与注解
-keep class dagger.hilt.** { *; }
-keep class javax.inject.** { *; }

# 保留Hilt生成的组件类名，运行时需要通过类名查找
-keepnames class * implements dagger.hilt.GeneratedComponent
-keepnames class * extends dagger.hilt.android.HiltApplication

# 保留Hilt自动生成的组件与模块类的成员
-keepclassmembers class **_HiltComponents { *; }
-keepclassmembers class **_HiltModules { *; }

# 保留带有Hilt注解的类成员
-keepclassmembers class * {
    @dagger.hilt.InstallIn <fields>;
    @dagger.hilt.Module <methods>;
    @dagger.hilt.android.AndroidEntryPoint <methods>;
}

# 保留Fragment上下文包装类的类名
-keepnames class * extends dagger.hilt.android.internal.managers.ViewComponentManager$FragmentContextWrapper

3. 保护自定义Hilt相关类 #

针对你自己编写的带有Hilt注解的类，补充以下规则确保它们的关键信息不丢失：

# 保留@AndroidEntryPoint标注的组件（Activity/Fragment等）的构造方法与类名
-keepnames class * {
    @dagger.hilt.android.AndroidEntryPoint <init>();
}

# 保留@HiltViewModel标注的ViewModel的构造方法与类名
-keepnames class * {
    @dagger.hilt.android.lifecycle.HiltViewModel <init>(...);
}

# 保留自定义Module类中的@Provides方法
-keepclassmembers class * {
    @dagger.Provides <methods>;
}

4. 配置Release构建类型 #

确保build.gradle中Release构建类型的混淆配置正确开启：

android {
    buildTypes {
        release {
            minifyEnabled true
            shrinkResources true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

常见排查点 #

• 如果仍崩溃，检查崩溃日志中找不到的类名，针对性添加-keep规则；
• 若使用Room、Retrofit等第三方库，需同时确保这些库的混淆规则正确配置；
• 避免在混淆规则中过度使用-assumenosideeffects等可能破坏Hilt运行逻辑的优化规则。

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