Hilt与WorkManager集成时NotificationSyncWorker出现NoSuchMethodException异常求助

我完全能理解你现在的困扰——明明看着配置都没问题，WorkManager却抛出NoSuchMethodException找不到Worker的构造方法。咱们先把问题拆解开，一步步排查和解决：

核心问题定位 #

这个异常的本质是：WorkManager默认的Worker工厂找不到符合(Context, WorkerParameters)签名的构造方法，但你的NotificationSyncWorker用了Hilt的@AssistedInject注入依赖，所以必须依赖Hilt生成的NotificationSyncWorker_Factory来创建实例。如果这个Factory类没生成，或者WorkManager没正确使用HiltWorkerFactory，就会触发这个异常。

针对性排查与解决方案 #

1. 修复KSP与KAPT混用的冲突 #

你目前用KSP处理核心Hilt注解，用KAPT处理Hilt-Work注解，这种混合使用不同注解处理器的方式很容易导致代码生成不完整（Hilt核心和Hilt-Work的注解处理器没协同工作，导致Worker_Factory类没生成）。

解决方案：统一注解处理器类型，二选一：

选项A：全部用KAPT处理（适配你当前的依赖版本）

修改build.gradle.kts的依赖配置，把核心Hilt的处理器从KSP换成KAPT：

dependencies {
    implementation(libs.hilt.android)
    kapt(libs.hilt.compiler) // 替换原来的ksp(libs.hilt.compiler)
    implementation(libs.hilt.navigation.compose)
    
    implementation(libs.androidx.work.runtime.ktx)
    implementation(libs.androidx.hilt.work)
    kapt(libs.androidx.hilt.work.compiler)
}

选项B：全部用KSP处理（推荐，更高效）

先升级androidx.hilt到支持KSP的最新稳定版（1.2.0），然后统一用KSP：

// 先在libs.versions.toml里更新版本
[versions]
hilt-android = "2.56.2"
hilt-work = "1.2.0"
work-runtime-ktx = "2.9.0"

// 然后在build.gradle.kts里配置
dependencies {
    implementation(libs.hilt.android)
    ksp(libs.hilt.compiler)
    
    implementation(libs.androidx.work.runtime.ktx)
    implementation(libs.androidx.hilt.work)
    ksp(libs.androidx.hilt.work.compiler) // 替换kapt为ksp
}

2. 修复依赖版本不兼容问题 #

你当前用的androidx.hilt:hilt-work:1.0.0是2021年的旧版本，和你用的WorkManager 2.9.0、Hilt 2.56.2存在兼容性风险。必须升级androidx.hilt到1.2.0，这个版本完美适配WorkManager 2.9.0和Hilt 2.56.2。

3. 验证Worker类的注解正确性 #

你的NotificationSyncWorker注解写法是对的，但再确认2点：

• 确保没有额外添加非@AssistedInject的构造方法；
• 确保NotificationDao和NotificationApi都是Hilt可注入的（比如Dao类加了@Dao且在Hilt Module里提供，Api类通过Hilt Module提供实例）。

4. 强制清理&重新构建 #

有时候旧的生成文件会残留，导致问题：

1. 执行Gradle -> Clean Project；
2. 手动删除项目根目录的build文件夹和模块下的build文件夹；
3. 执行Gradle -> Sync Project with Gradle Files；
4. 最后Rebuild Project。

调试Hilt代码生成的实用技巧 #

如果以上步骤还没解决问题，你可以通过以下方式定位注解处理器的问题：

• 检查生成的Factory类：

  • 用KAPT的话，去build/generated/source/kapt/debug/[你的包名]/data/worker/下找NotificationSyncWorker_Factory类；
  • 用KSP的话，去build/generated/ksp/debug/[你的包名]/data/worker/下找这个类。
    如果找不到这个类，说明注解处理器完全没处理@HiltWorker注解，问题肯定出在依赖或处理器配置上。

• 启用注解处理器日志：
  在gradle.properties里添加对应配置，重新构建后查看日志的错误/警告：

  • KAPT：kapt.verbose=true
  • KSP：ksp.logLevel=verbose

• 检查版本兼容性：
  确保所有依赖版本匹配：

  • Hilt核心版本（2.56.2）和androidx.hilt版本（1.2.0）兼容；
  • WorkManager（2.9.0）和androidx.hilt:hilt-work（1.2.0）兼容。

最后验证 #

修改完配置并重新构建后，运行应用，触发WorkManager调度，看看是否还会抛出异常。如果Factory类成功生成，且WorkManager用了HiltWorkerFactory，问题应该就能解决了。

内容来源于stack exchange