Hilt生成Hilt_前缀Fragment时如何正确使用Navigation组件

问题根因 #

给Fragment添加@AndroidEntryPoint注解后，Hilt会在编译阶段自动生成名为Hilt_<原Fragment类名>的包装子类，用来承载依赖注入的相关逻辑。Android Studio的Navigation Editor在扫描类路径时会优先识别到这个自动生成的类，自动将其填充为导航目的地的目标类，最终导致编译时尝试直接实例化Hilt生成的包装类、抛出构造函数找不到的异常。

修复步骤 #

• 手动修正导航图的类配置
  打开res/navigation目录下对应的导航XML文件，找到出问题的Fragment目的地节点，将android:name属性里自动填充的Hilt_前缀去掉，配置为你自己编写的原始Fragment全限定类名即可，比如将com.blah.blah.fragment.Hilt_HomeFragment改回com.blah.blah.fragment.HomeFragment。Hilt的注入逻辑会在编译期自动关联到原始Fragment，不需要在导航配置里直接引用生成类。
• 规范Fragment构造函数写法
  所有标记@AndroidEntryPoint的Fragment必须显式声明无参公共构造函数，不要给Fragment自定义带参数的构造方法，所有需要注入的依赖全部通过@Inject注解标注字段实现（Java开发注意被注入的字段不要设置为private，否则Hilt无法完成注入），否则即使类名配置正确也会抛出实例化异常。
• 处理IDE显示异常
  如果修改完XML切回Navigation Editor，界面上依然显示带Hilt_前缀的类名，属于IDE静态索引的识别bug，不影响实际编译运行。如果需要修正显示，依次点击菜单栏Build -> Clean Project，再执行Build -> Rebuild Project，等待项目索引重建完成后显示就会恢复正常。
• 避开自定义FragmentFactory的错误配置
  如果项目里自定义了FragmentFactory，不要手动尝试实例化Hilt_开头的自动生成类，所有Fragment实例化逻辑都针对自己编写的原始Fragment类处理即可，Hilt会自动完成注入拦截。

典型报错 #

Caused by: androidx.fragment.app.Fragment$InstantiationException: Unable to instantiate fragment com.blah.blah.fragment.Hilt_HomeFragment: could not find Fragment constructor

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