开源项目open-ani中NSFW内容过滤导致的列表滚动问题解析

在开源动漫应用open-ani的开发过程中，团队发现了一个与NSFW(Not Safe For Work)内容过滤相关的UI显示问题。这个问题主要影响收藏列表的滚动体验，当用户浏览包含隐藏内容的长列表时会出现位置回溯现象。

问题本质分析

该问题的核心在于数据过滤逻辑的实现位置不当。当前实现是在分页器(pager)层面进行NSFW内容过滤，这导致了以下几个技术层面的问题：

1. 分页索引计算不准确：由于过滤发生在数据到达客户端之后，分页器维护的索引与实际显示的项目数量不匹配
2. 滚动位置不稳定：当用户滚动浏览时，客户端动态过滤内容会导致列表长度变化，引发位置跳变
3. 性能损耗：所有数据都需要传输到客户端后再进行过滤，浪费了网络带宽和处理资源

技术解决方案

正确的实现方式应该将过滤逻辑下推到数据库查询层。这种架构调整带来以下优势：

1. 数据一致性：数据库返回的已经是过滤后的结果，客户端无需二次处理
2. 精确分页：分页器基于实际显示的数据量工作，索引计算准确
3. 性能优化：减少了不必要的数据传输，提升了整体响应速度

实现要点

在具体实现时，开发团队需要注意：

1. 数据库查询必须包含NSFW过滤条件
2. 分页参数需要基于过滤后的结果集计算
3. 客户端UI无需关心过滤逻辑，只需展示接收到的数据
4. 用户偏好设置(如显示/隐藏NSFW)需要实时反映在查询条件中

用户体验影响

这个修复对于用户最直接的改善是：

1. 滚动浏览收藏列表时不再出现位置跳变
2. 加载速度有所提升，特别是对于大型收藏列表
3. 内容显示更加稳定可靠

总结

这个案例很好地展示了数据处理位置选择的重要性。在客户端进行数据过滤虽然实现简单，但会带来一系列衍生问题。将过滤逻辑下推到数据库层不仅解决了UI问题，还带来了性能提升，是更优雅的架构设计方案。open-ani团队通过这个修复，为用户提供了更加流畅稳定的内容浏览体验。