Kotlin技术问询：RecyclerView填充数据时在API26/28/30崩溃，API33正常

这种仅在API 26/28/30崩溃、API 33正常的现象，核心原因几乎都是使用了仅在更高API级别才支持的方法/类，或是忽略了不同API版本下的行为差异。结合RecyclerView绑定ArrayList的场景，下面给出常见原因排查和修复方案：

1. 优先定位崩溃核心信息 #

先从崩溃日志中提取关键异常类型，这是最快的排查路径：

• UnsupportedOperationException：大概率是尝试修改不可变列表（比如List.of()、Arrays.asList()创建的列表，或是系统API返回的不可变集合）。API 33可能因代码路径未触发修改操作而未崩溃。
• NoSuchMethodError：明确说明调用了仅在API 30+才存在的方法（比如Objects.requireNonNullElse、List#reversed()等）。
• NullPointerException/InflateException：可能是布局使用了高API专属属性，或是数据对象在低版本设备上为null。

2. 常见场景的修复方案 #

（1）替换高API专属方法 #

如果是NoSuchMethodError，比如使用了API 30才引入的Objects.requireNonNullElse，直接替换为兼容写法：

// 原高API写法（API 30+）
String name = Objects.requireNonNullElse(data.getName(), "默认名称");

// 兼容API 26+的写法
String name = data.getName() != null ? data.getName() : "默认名称";

或者使用AndroidX兼容库的工具类（推荐），它会自动处理版本兼容：

import androidx.core.util.ObjectsCompat;

String name = ObjectsCompat.requireNonNullElse(data.getName(), "默认名称");

（2）避免修改不可变列表 #

如果是UnsupportedOperationException，检查ArrayList的创建逻辑：

// 错误：List.of()创建的是不可变列表，调用add/remove会崩溃
List<MyData> dataList = List.of(new MyData(), new MyData());

// 正确：转为可变ArrayList再操作
List<MyData> dataList = new ArrayList<>(List.of(new MyData(), new MyData()));

如果是从系统接口获取的列表，同样先转为可变集合再填充到RecyclerView：

List<MyData> systemData = getSystemData();
List<MyData> mutableData = new ArrayList<>(systemData);
adapter.submitList(mutableData);

（3）RecyclerView Adapter的兼容处理 #

如果使用ListAdapter+DiffUtil，确保DiffUtil.ItemCallback的实现没有依赖高API方法：

// 稳妥的兼容写法（API 26+全支持）
@Override
public boolean areContentsTheSame(@NonNull MyData oldItem, @NonNull MyData newItem) {
    return oldItem.getTitle().equals(newItem.getTitle())
            && oldItem.getCount() == newItem.getCount();
}

另外，更新数据时务必使用submitList()（ListAdapter）或notifyDataSetChanged()等规范方法，避免在数据更新时直接操作列表引发并发问题。

（4）布局文件的属性兼容检查 #

如果是InflateException，检查布局中是否使用了API 31+的属性，比如android:contextClickable。对于高API属性，要么替换为兼容写法，要么添加tools:targetApi="31"并在代码中通过ViewCompat设置：

<!-- 布局中添加targetApi标记避免编译警告 -->
<TextView
    android:id="@+id/tv_title"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:tooltipText="提示文本"
    tools:targetApi="26" />

代码中用兼容类设置：

ViewCompat.setTooltipText(tvTitle, "提示文本");

3. 通用排查流程 #

1. 从崩溃日志中找到栈顶的代码行，确定是数据填充环节还是视图绑定环节出错。
2. 选中出错的方法/类，查看Android Studio的代码提示（会标注@RequiresApi(api = XX)），确认是否超出minSdk版本。
3. 替换为兼容实现后，在API 26、28、30的模拟器上逐一验证。

内容的提问来源于stack exchange，提问作者Dr. Wo