Animation-Garden项目中NSFW内容隐藏导致的列表滚动回溯问题解析

在Animation-Garden这类内容聚合应用中，正确处理敏感内容(NSFW)的展示逻辑是保证用户体验的重要环节。近期项目中出现了一个值得深入探讨的技术问题：当用户浏览收藏列表时，如果开启了NSFW内容隐藏功能，在滚动过程中会出现页面位置回溯的现象。

问题本质分析

这个问题的核心在于数据分页处理逻辑与内容过滤逻辑的耦合方式不当。具体表现为：

1. 分页机制缺陷：当前实现是在客户端获取完整数据后，再进行NSFW内容过滤，这导致分页索引与实际显示内容不匹配
2. 滚动位置计算错误：当隐藏NSFW内容后，客户端维护的滚动位置是基于完整数据集的，而实际显示的内容量减少，导致位置计算出现偏差
3. 数据库查询优化不足：过滤操作没有在数据库查询层面完成，增加了不必要的网络传输和客户端计算负担

技术解决方案

正确的实现方案应该遵循以下原则：

1. 服务端过滤优先：所有内容过滤(包括NSFW)必须在数据库查询时完成，确保返回给客户端的数据已经是过滤后的结果
2. 分页索引一致性：分页参数(pager)应该基于过滤后的数据集进行计算，保持索引的连续性
3. 客户端状态同步：滚动位置等UI状态应该基于实际显示的内容量进行计算和维护

具体到Room/Pager的实现，需要：

// 错误实现：客户端过滤
fun loadPage(page: Int) {
    repository.getRooms(page).filter { !it.isNsfw || showNsfw }
}

// 正确实现：服务端过滤
fun loadPage(page: Int) {
    repository.getRooms(page, filterNsfw = !showNsfw)
}

性能与体验优化

除了解决核心问题外，这个案例还给我们带来了一些架构设计上的启示：

1. 计算下推原则：尽可能将过滤、排序等计算操作下推到数据源附近执行
2. 分页稳定性：确保分页结果集是稳定的，不会因为客户端设置的改变而影响分页连续性
3. 状态管理：UI状态应该与真实显示内容保持严格同步，避免基于假设进行计算

总结

Animation-Garden项目中遇到的这个滚动回溯问题，典型地展示了内容过滤与分页机制的交互陷阱。通过将过滤逻辑迁移到服务端实现，不仅解决了UI异常问题，还优化了整体性能。这类问题的解决方案具有普适性，对于任何需要结合内容过滤和分页加载的应用场景都有参考价值。