设置TextView静态文本偶发ArrayIndexOutOfBoundsException崩溃排查

Hey there, let's unpack this tricky intermittent crash you're hitting in production—those "works everywhere except when users are using it" bugs are the worst! I've dealt with similar TextView Spannable-related weirdness before, so here's what's going on and how to fix it:

根因分析 #

• SpannableStringBuilder线程不安全：TextView的内部文本处理依赖SpannableStringBuilder，而这个类本身不是线程安全的。哪怕你认为自己是在主线程调用，生产环境里也会有边缘情况——比如第三方库在非主线程触发回调、系统UI事件带来的主线程微小并发操作——这些都可能导致Spannable的内部数组被并发修改，进而抛出ArrayIndexOutOfBoundsException。
• SpanWatcher空指针陷阱：把文本提取为局部变量后出现的NPE，大概率是因为TextView注册的SpanWatcher被意外置空，而系统在处理Span变更时没有做空指针校验。这种情况通常和TextView的生命周期状态有关——比如View已经销毁但Binding还持有引用，或者系统回收资源时出现异常状态。

针对性修复方案 #

1. 强制主线程执行 #

哪怕你确信自己在主线程，加个校验也能避免非主线程调用导致的Spannable损坏：

fun updateFilterInfo(showing: Int, total: Int) {
    val displayText = "$showing / $total"
    binding?.tvFilterLvl1?.let { textView ->
        if (Looper.myLooper() != Looper.getMainLooper()) {
            textView.post { textView.text = displayText }
        } else {
            textView.text = displayText
        }
    }
}

2. 避免隐式Spannable转换 #

字符串拼接生成的CharSequence有时会被系统隐式转为Spannable，触发不必要的Span处理。可以明确使用String类型，或者手动创建无冲突的Spannable：

// 方案1：明确使用String（最简单）
fun updateFilterInfo(showing: Int, total: Int) {
    val displayText = String.format("%d / %d", showing, total)
    binding?.tvFilterLvl1?.text = displayText
}

// 方案2：手动创建无Span的SpannableStringBuilder
fun updateFilterInfo(showing: Int, total: Int) {
    val displayText = "$showing / $total"
    binding?.tvFilterLvl1?.text = SpannableStringBuilder(displayText).apply {
        clearSpans() // 清空所有默认Span，避免潜在冲突
    }
}

3. 校验TextView生命周期状态 #

修改TextView前先确认它仍附着在窗口上，避免操作已经销毁的View：

fun updateFilterInfo(showing: Int, total: Int) {
    binding?.tvFilterLvl1?.takeIf { it.isAttachedToWindow }?.let { textView ->
        textView.text = "$showing / $total"
    }
}

4. 升级依赖版本 #

你当前使用的Kotlin 1.3.21、Gradle插件3.3.2和旧版AndroidX都比较陈旧，很多TextView相关的Bug已经在新版本中修复：

• Kotlin：升级到1.7.x及以上稳定版
• Gradle插件：升级到7.x及以上稳定版
• AndroidX库：同步升级到对应版本的稳定版

为什么测试环境复现不了？ #

这种偶发崩溃通常源于测试环境难以模拟的复杂场景：高并发UI操作、特定旧Android版本的系统Bug、罕见的后台任务调度时机等。防御性编码是应对这类问题的最优解。

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