带PagedListAdapter的RecyclerView快速滑动时崩溃原因排查

阿华AIGC实验室

2026-5-27

问题原因分析与解决方案

这个问题我之前处理过，核心矛盾出在PositionalDataSource的设计逻辑和你用GROUP BY的查询特性不匹配上，快速滚动只是触发问题的诱因，咱们一步步拆解：

为什么快速滚动会触发null崩溃？

PositionalDataSource是专为位置固定、连续且稳定的数据集设计的——它的工作逻辑是先查询总记录数，然后基于位置（比如第20-40条）分批加载数据。但你的GROUP BY查询破坏了这个前提：

结果集顺序不稳定：默认情况下，GROUP BY不会保证返回结果的顺序（除非显式加ORDER BY），这意味着每次加载数据时，同一位置对应的记录可能不一样。快速滚动时，PagedList会快速请求多个位置的批次，一旦位置映射关系混乱，就会出现“预期有数据但实际加载不到”的情况，导致getItem(position)返回null。
Count查询与实际加载不一致：PositionalDataSource会自动执行SELECT COUNT(*) FROM (你的分组查询)来获取总条数，但如果分组后的结果集因为数据变化（比如插入/删除用户）或者SQLite的分组行为（比如无聚合函数时随机返回分组内记录），会导致count的结果和实际加载的记录数不匹配。快速滚动时，PagedList会根据count值认为某个位置存在数据，但实际加载时该位置没有对应的记录，就会返回null。
分组查询的不确定性：你的查询SELECT * FROM Users GROUP BY locality,fullName没有指定聚合函数，SQLite会随机返回每个分组中的一条记录，这进一步加剧了结果集的不稳定性——每次加载同一位置的数据，可能得到不同的记录，甚至在极端情况下出现批次缺失。

可行的解决方案

方案1：给分组查询添加稳定的排序和确定性聚合

让结果集的顺序和内容固定下来，适配PositionalDataSource的要求：

@Dao 
public abstract class UserDao { 
    // 加上ORDER BY确保顺序稳定，同时用聚合函数指定分组返回的记录（比如取每个分组ID最大的用户）
    @Query("SELECT * FROM Users GROUP BY locality,fullName ORDER BY locality, fullName")
    public abstract PositionalDataSource.Factory<Integer, User> getUserLocalityGrouped(); 
}

如果需要更明确的分组结果，建议指定聚合逻辑，比如：

@Query("SELECT *, MAX(id) as max_id FROM Users GROUP BY locality,fullName ORDER BY locality, fullName")

这样每个分组只会返回ID最大的用户，结果集完全确定，不会出现随机变化。

方案2：改用非位置依赖的DataSource类型

如果分组后的结果集本身可能频繁变化（比如用户数据经常更新），PositionalDataSource不是最佳选择，建议换成ItemKeyedDataSource或PageKeyedDataSource：

ItemKeyedDataSource：基于每条记录的唯一键来加载下一页数据，适合排序后的数据集；
PageKeyedDataSource：基于页码（或前后页的键）来加载，适合分页明确的场景。

以ItemKeyedDataSource为例，你需要修改Dao提供分页查询的方法：

@Dao 
public abstract class UserDao { 
    @Query("SELECT * FROM Users GROUP BY locality,fullName ORDER BY locality, fullName LIMIT :limit OFFSET :offset")
    public abstract List<User> getGroupedUsers(int offset, int limit);

    @Query("SELECT COUNT(*) FROM (SELECT * FROM Users GROUP BY locality,fullName)")
    public abstract int getGroupedUserCount();
}

然后手动实现ItemKeyedDataSource，通过键（比如用户的locality+fullName组合）来加载前后数据，避免位置依赖带来的问题。