Android中Broadcast Receiver调用Service方法及下载取消失效求助

问题现象 #

为TrackDownloadService实现同步下载机制后，点击通知的「取消」按钮无法触发cancelDownload()方法终止下载。DownloadCancelReceiver能正常接收取消Intent，但无法调用服务中的cancelDownload()，导致取消功能完全失效。

核心问题定位 #

1. 服务实例未初始化：TrackDownloadService的静态instance变量从未被赋值，导致getInstance()始终返回null，Receiver中TrackDownloadService.getInstance()?.cancelDownload()的调用实际不会执行任何操作。
2. Receiver注册逻辑不完整：仅在Android O及以上版本注册Receiver，低版本系统中Receiver未注册（虽用户反馈Receiver能收到Intent，但需统一兼容）。

修复方案 #

1. 正确维护服务实例 #

在服务生命周期中初始化和清空instance变量，确保Receiver能获取到有效服务实例：

• 在onCreate()中赋值instance = this
• 在onDestroy()中置空instance = null，避免内存泄漏

2. 统一Receiver注册逻辑 #

移除版本判断，确保所有系统版本都正确注册Receiver，低版本无需RECEIVER_NOT_EXPORTED参数。

3. 可选优化：简化取消流程 #

直接在TrackDownloadService的onStartCommand()中处理取消Intent，无需通过BroadcastReceiver，减少组件依赖。

修改后的关键代码片段 #

TrackDownloadService 核心修改 #

companion object {
    const val TAG = "TrackDownloadService"
    private lateinit var cancelPendingIntent: PendingIntent
    private var instance: TrackDownloadService? = null

    fun getInstance(): TrackDownloadService? {
        return instance
    }
    // ... 其他方法保持不变
}

override fun onCreate() {
    super.onCreate()
    Log.d(TAG, "OnCreate $TAG")
    instance = this // 新增：初始化服务实例
    createNotificationChannel()
    startForeground(NOTIFICATION_ID, createNotification("Starting download..."))
    
    // 修改：统一注册Receiver，兼容所有Android版本
    cancelReceiver = DownloadCancelReceiver()
    val intentFilter = IntentFilter(DownloadCancelReceiver.ACTION_CANCEL_DOWNLOAD)
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        registerReceiver(cancelReceiver, intentFilter, RECEIVER_NOT_EXPORTED)
    } else {
        registerReceiver(cancelReceiver, intentFilter)
    }

    downloadScope = CoroutineScope(Dispatchers.IO)
    initiateDownloadProcess()
}

override fun onDestroy() {
    super.onDestroy()
    Log.d(TAG, "Service onDestroy is called")
    unregisterReceiver(cancelReceiver)
    instance = null // 新增：清空实例，避免内存泄漏
}

可选优化：直接在服务中处理取消Intent #

如果不需要独立Receiver，可修改onStartCommand()直接响应取消动作：

override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
    intent?.let {
        if (it.action == DownloadCancelReceiver.ACTION_CANCEL_DOWNLOAD) {
            cancelDownload()
        }
    }
    return START_STICKY
}

同时修改通知中PendingIntent的目标为服务本身：

private fun createNotification(contentText: String): Notification {
    val cancelIntent = Intent(this, TrackDownloadService::class.java).apply {
        action = DownloadCancelReceiver.ACTION_CANCEL_DOWNLOAD
    }
    // ... 其余通知构建代码保持不变
}

验证要点 #

• 点击取消按钮后，查看Logcat是否输出Download cancellation requested.和Download canceled!
• 确认下载线程终止，临时文件被删除
• 检查服务销毁时instance是否被置空，避免内存泄漏

内容的提问来源于stack exchange，提问作者Abdullah Al Nahian Kanon