Android Kotlin中如何取消CountDownTimer？解决销毁后仍运行问题

问题重现 #

在Kotlin Fragment中实现CountDownTimer后，按下返回键或最小化应用时，仅在onDestroy()中调用cancel()无法停止计时器，Logcat仍能看到onTick日志输出，最终Fragment销毁后onFinish()执行导航操作抛出致命异常：

java.lang.IllegalStateException: Fragment Gameplay{735bc2f} (915d1b65-13a2-40f3-b94a-4519fde2252d) not associated with a fragment manager.

核心原因 #

1. 生命周期调用时机偏差：onDestroy()不会在返回/最小化场景下立即触发（比如最小化应用时，Fragment仅执行onPause()/onStop()），导致计时器未被及时终止。
2. 内存泄漏引发持续运行：CountDownTimer的匿名内部类持有Fragment实例引用，即使Fragment视图销毁，计时器仍会继续运行，且无法被GC回收。

解决方案 #

1. 多生命周期节点取消计时器 #

不要仅依赖onDestroy()，在Fragment的onPause()、onStop()、onDestroy()中都加入取消逻辑，覆盖返回、最小化等所有需要停止计时器的场景：

override fun onPause() {
    super.onPause()
    countDownTimer?.cancel()
}

override fun onStop() {
    super.onStop()
    countDownTimer?.cancel()
}

override fun onDestroy() {
    super.onDestroy()
    countDownTimer?.cancel()
    countDownTimer = null // 置空切断引用链，避免内存泄漏
    binding = null
}

2. 空安全调用与内存防护 #

• 调用cancel()前始终做空安全判断（countDownTimer?.cancel()），避免空指针异常。
• 在onDestroy()中将计时器置为null，帮助GC回收相关资源。

3. 增强onFinish()的安全性 #

即使计时器未被及时取消，也要确保onFinish()中的操作不会崩溃，通过isAdded()判断Fragment是否仍依附于Activity：

countDownTimer = object : CountDownTimer(Constants.timerDuration, 1000) {
    override fun onTick(millisecondFinished: Long) {
        binding?.tvTimer?.text = (millisecondFinished / 1000).toString()
        Log.i("millis", "onTick: $millisecondFinished")
    }

    override fun onFinish() {
        // 仅当Fragment处于活跃状态时执行导航
        if (isAdded) {
            val action = GameplayDirections.actionGameplayToGameover()
            findNavController().navigate(action)
        }
    }
}.start()

最终完整代码示例 #

计时器初始化 #

private var countDownTimer: CountDownTimer? = null

private fun startTimer() {
    countDownTimer = object : CountDownTimer(Constants.timerDuration, 1000) {
        override fun onTick(millisecondFinished: Long) {
            binding?.tvTimer?.text = (millisecondFinished / 1000).toString()
            Log.i("millis", "onTick: $millisecondFinished")
        }

        override fun onFinish() {
            if (isAdded) {
                val action = GameplayDirections.actionGameplayToGameover()
                findNavController().navigate(action)
            }
        }
    }.start()
}

生命周期取消逻辑 #

override fun onPause() {
    super.onPause()
    countDownTimer?.cancel()
}

override fun onStop() {
    super.onStop()
    countDownTimer?.cancel()
}

override fun onDestroy() {
    super.onDestroy()
    countDownTimer?.cancel()
    countDownTimer = null
    binding = null
}

内容的提问来源于stack exchange，提问作者Akash Adhikary