Lottie动画按钮触发StackOverflowError问题排查与解决求助

一、问题核心原因 #

从Crashlytics报错堆栈能直接定位：HomeActivity的onAnimationEnd方法里反复调用playAnimation()，形成无限递归循环——动画播放结束触发onAnimationEnd，回调里又启动动画，动画结束再次触发回调，循环往复直到栈内存耗尽，最终抛出StackOverflowError。

二、复现方法（针对本地未复现的情况） #

试试这几个特定场景，大概率能触发问题：

• 快速连续点击按钮：在动画播放过程中高频点击触发playAnimation()，打乱动画状态机，导致onAnimationEnd被重复触发
• 后台前台快速切换：动画播放时把应用切到后台，立刻切回前台，部分设备上Lottie的动画状态会异常，触发重复回调
• 动画配置冲突：检查xml里Lottie的repeatCount是否设为INFINITE，同时代码里还手动调用playAnimation()，两种循环逻辑叠加导致死循环
• 多线程交叉触发：如果有其他线程（比如直播状态的网络回调）也调用playAnimation()，和UI线程的onAnimationEnd回调形成交叉触发

三、解决方案 #

1. 修复回调逻辑，添加状态校验 #

在onAnimationEnd里加标记位或状态判断，避免无条件调用playAnimation()：

private var isAnimationTriggered = false

override fun onAnimationEnd(animation: Animator?) {
    // 只有当需要触发下一次动画且当前无动画执行时才调用
    if (!liveButton.isAnimating && !isAnimationTriggered) {
        isAnimationTriggered = true
        liveButton.playAnimation()
        isAnimationTriggered = false
    }
}

2. 用Lottie原生配置实现循环（推荐） #

如果按钮需要循环动画，直接在xml里配置，不要手动在回调里触发，避免逻辑冲突：

<com.airbnb.lottie.LottieAnimationView
    android:id="@+id/live_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:lottie_fileName="live_animation.json"
    app:lottie_repeatCount="infinite" <!-- 原生循环配置 -->
    app:lottie_autoPlay="false"/>

3. 统一动画触发入口，避免重复调用 #

把所有触发动画的逻辑集中到一个方法，添加状态校验：

fun startLiveAnimation() {
    // 只有当前没有在动画时才启动
    if (!liveButton.isAnimating) {
        liveButton.playAnimation()
    }
}

4. 及时清理动画监听 #

在Activity销毁时移除动画回调，防止异常场景下的回调触发：

override fun onDestroy() {
    super.onDestroy()
    liveButton.removeAnimatorListener(this)
}

内容的提问来源于stack exchange，提问作者Jesús García