Android应用因IndexOutOfBoundsException崩溃求助：setSpan越界问题

问题背景 #

应用频繁触发java.lang.IndexOutOfBoundsException异常，报错核心信息为setSpan (-1 ... -1) starts before 0，调用栈指向Android系统无障碍服务（Accessibility）相关逻辑。目前仅在开启TalkBack的设备上复现过崩溃，但无法确认所有崩溃用户均开启该功能。

具体排查思路 #

• 聚焦无障碍服务场景，覆盖全量测试
  既然TalkBack开启时能稳定复现，优先针对无障碍模式做深度测试：

  • 覆盖不同Android版本（重点关注调用栈涉及的系统版本，如报错中ActivityThread.java:8302对应Android 12/13系列），测试原生TextView、AppCompatTextView及自定义TextView子类在TalkBack开启后的行为；
  • 重点验证动态文本更新场景：列表滚动时实时刷新文本、异步加载完成后设置文本、文本为空/长度为0时的操作，确认是否触发崩溃。

• 检查TextView的Span处理逻辑
  异常本质是setSpan的范围参数非法，结合调用栈是系统处理无障碍节点时触发，需排查：

  • 应用中是否给TextView设置了自定义Span（如ClickableSpan、ForegroundColorSpan），尤其是文本为空时未清除Span的情况；
  • 核对动态计算Span索引的逻辑：是否存在索引值为负数、或超出文本实际长度的情况，即使未直接调用setSpan，自定义TextView重写的onInitializeAccessibilityNodeInfo方法也可能间接触发该异常；
  • 为空文本场景添加防护：若TextView可能显示空内容，设置文本时同步清除所有Span，或避免在空文本上绑定Span。

• 重写TextView无障碍方法做异常拦截
  崩溃发生在系统的onInitializeAccessibilityNodeInfoInternal方法中，可通过重写该方法添加防护：

  @Override
  public void onInitializeAccessibilityNodeInfoInternal(AccessibilityNodeInfo info) {
      try {
          // 文本为空时提前清空Span
          if (TextUtils.isEmpty(getText())) {
              setText(null);
          }
          super.onInitializeAccessibilityNodeInfoInternal(info);
      } catch (IndexOutOfBoundsException e) {
          // 捕获异常避免崩溃，同时上报日志便于分析
          Log.e(TAG, "Accessibility node init failed", e);
      }
  }
  

• 分析崩溃用户的设备数据
  结合崩溃统计平台数据定位规律：

  • 筛选崩溃用户的Android版本、设备型号，确认是否集中在特定版本或机型；
  • 查看用户设备的无障碍服务状态（部分平台可采集该信息），验证崩溃是否仅发生在无障碍服务开启时；
  • 梳理崩溃发生的页面与操作路径，锁定高频触发场景。

• 排查系统层面已知Bug
  部分Android版本可能存在无障碍服务的原生Bug：

  • 查阅Android官方Issue Tracker，搜索setSpan (-1 ... -1) starts before 0相关问题，确认是否有官方修复方案或版本补丁；
  • 若问题集中在特定系统版本，可尝试调整TargetSdkVersion或通过兼容性适配规避。

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