生产构建变体中出现WorkManager未初始化异常求助

1. 定位间接引入WorkManager的第三方库 #

你没手动加WorkManager依赖，大概率是某个第三方库间接带进来的。用Gradle命令查依赖树：

./gradlew app:dependencies --configuration releaseRuntimeClasspath

搜索workmanager相关条目，就能找到是哪个库引入的。

2. 检查合并后的Manifest #

生产构建的Manifest可能被第三方库或构建脚本修改，导致WorkManager默认初始化被禁用。去app/build/intermediates/merged_manifests/release目录查看合并后的Manifest，确认是否存在类似代码：

<provider
    android:name="androidx.startup.InitializationProvider"
    android:authorities="${applicationId}.androidx-startup"
    android:exported="false"
    tools:node="merge">
    <meta-data
        android:name="androidx.work.WorkManagerInitializer"
        tools:node="remove" />
</provider>

如果有tools:node="remove"，说明默认初始化被移除，但间接引入的依赖还是会触发WorkManager初始化逻辑，导致报错。

3. 三种修复方案任选 #

方案一：恢复默认初始化 #

如果不需要禁用默认初始化，直接删除或注释Manifest中tools:node="remove"的相关配置，让系统自动初始化：

<provider
    android:name="androidx.startup.InitializationProvider"
    android:authorities="${applicationId}.androidx-startup"
    android:exported="false"
    tools:node="merge">
    <!-- 删除或注释下面这行 -->
    <!-- <meta-data android:name="androidx.work.WorkManagerInitializer" tools:node="remove" /> -->
</provider>

方案二：手动初始化WorkManager（必须禁用默认初始化的情况） #

如果确实要禁用默认初始化，在自定义Application类的onCreate()中手动初始化：

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        val config = Configuration.Builder().build()
        WorkManager.initialize(this, config)
    }
}

或者让Application实现Configuration.Provider接口：

class MyApplication : Application(), Configuration.Provider {
    override fun getWorkManagerConfiguration(): Configuration {
        return Configuration.Builder().build()
    }
}

方案三：排除间接引入的WorkManager依赖 #

如果确定完全不需要WorkManager，找到对应的第三方库，在Gradle中排除依赖：

implementation("com.example.thirdparty:library:1.0.0") {
    exclude group: "androidx.work", module: "work-runtime"
}

注意：排除前要确认第三方库不会因缺少WorkManager而崩溃。

4. 验证修复 #

重新打包生产构建，测试运行是否还会触发该错误，同时检查Sentry面板是否停止上报该异常。

内容的提问来源于stack exchange，提问作者sahar shamloo