KitKat（API 19）使用矢量图触发StackOverflowError问题求助

开发者阿泽

2026-5-20

解决API 19（KitKat）上RecyclerView矢量图导致StackOverflowError的问题

这种低版本设备上矢量图引发栈溢出的问题我碰到过好几次，大概率是矢量图的兼容处理细节没做对，咱们一步步排查解决：

核心问题根源

API 19本身不支持矢量图（VectorDrawable），虽然你开启了全局兼容开关，但如果视图引用或类型没配合好，RecyclerView的条目复用会放大渲染逻辑的递归问题，最终导致栈溢出。

替换原生ImageView为AppCompatImageView
原生ImageView在API 19上对矢量图的兼容处理存在缺陷，换成androidx.appcompat.widget.AppCompatImageView能借助Support Library的逻辑正确解析矢量图，避免递归渲染触发栈溢出。
用app:srcCompat替代android:src引用矢量图
即使开了全局兼容，原生android:src属性在低版本仍会尝试直接解析矢量图，而app:srcCompat是Support Library提供的专属属性，会自动处理矢量图的兼容转换。记得在布局根节点声明app命名空间：
```
xmlns:app="http://schemas.android.com/apk/res-auto"
```
示例布局代码：
```
<androidx.appcompat.widget.AppCompatImageView
    android:layout_width="48dp"
    android:layout_height="48dp"
    app:srcCompat="@drawable/your_vector_icon" />
```
确保RecyclerView的复用逻辑正确
虽然PNG图没问题，但矢量图渲染开销更大，若ViewHolder里的ImageView未正确复用，会重复创建渲染逻辑加剧栈压力。确认onCreateViewHolder只创建一次视图，onBindViewHolder仅做数据绑定操作，不要在绑定方法里重复初始化Drawable。
验证全局兼容开关的执行时机
确保AppCompatDelegate.setCompatVectorFromResourcesEnabled(true);是在Application类onCreate()方法的最开始调用，避免被其他初始化逻辑延迟或覆盖。

如果以上步骤都试过仍有问题，可以尝试手动解析矢量图后再设置：
在onBindViewHolder中用Support Library的工具类获取Drawable：

Drawable vectorDrawable = AppCompatResources.getDrawable(context, R.drawable.your_vector_icon);
holder.imageView.setImageDrawable(vectorDrawable);

内容的提问来源于stack exchange，提问作者y.allam