@HiltWorker中使用Hilt字段注入时为何出现注入值为null的问题

核心根因 #

问题本质是手动初始化WorkManager时漏配了Hilt专属的WorkerFactory。WorkManager的默认实例化逻辑是通过反射直接调用Worker的构造方法创建对象，完全不会触发Hilt的依赖注入流程，这就是@Inject标记的字段始终为null的直接原因。

修复步骤 #

• 替换自定义初始化逻辑，接入HiltWorkerFactory
  先在Application类中标注@HiltAndroidApp，完成Hilt入口初始化，再注入Hilt提供的Worker工厂，替换原有Configuration的构建逻辑：

  @HiltAndroidApp
  public class MyApplication extends Application {
      // 该工厂负责驱动@HiltWorker的实例化流程，触发字段注入逻辑
      @Inject
      HiltWorkerFactory workerFactory;
  
      @Override
      public void onCreate() {
          super.onCreate();
          // 给WorkManager配置传入Hilt的WorkerFactory，替换原有无工厂的配置
          Configuration myConfig = new Configuration.Builder()
                  .setWorkerFactory(workerFactory)
                  .setMinimumLoggingLevel(android.util.Log.INFO)
                  .build();
          // 注意：手动初始化WorkManager的时机必须早于所有访问WorkManager单例的代码，建议直接放在Application.onCreate中
          WorkManager.initialize(this, myConfig);
      }
  }
  

• 校验Manifest配置正确性
  你当前移除WorkManager默认初始化的Provider配置是正确的，不需要额外调整，只要保证authorities属性匹配应用包名即可：

  <provider
      android:name="androidx.work.impl.WorkManagerInitializer"
      android:authorities="${applicationId}.workmanager-init"
      tools:node="remove" />
  

• 排查常见踩坑点
  • 确认已引入对应版本的hilt-work依赖，缺失依赖会导致@HiltWorker的注解处理器不生成注入桥接代码，注入逻辑完全失效
  • 不要在Worker的构造方法中访问@Inject标记的字段：Hilt的字段注入流程是在Worker实例创建完成后才触发的，构造方法执行阶段字段仍为null，需在doWork()方法执行阶段再访问注入对象
  • 确认被注入的依赖（如代码中的SessionManager）已在Hilt依赖图中完成可注入声明，具备带@Inject标记的构造方法

内容的提问来源于stack exchange，提问作者Qandeel Haider