PHP实现动态排序聊天列表分页拉取逻辑咨询

你当前使用的基于last_id匹配索引偏移的分页逻辑，仅适用于排序规则固定、元素位置不会发生变动的列表。聊天列表按「会话最后一条消息时间」动态排序，新消息到达时对应会话会直接置顶，使用索引偏移必然出现重复拉取、漏拉条目问题，需要改用基于排序字段的游标分页方案，实现逻辑如下： #

核心实现规则 #

1. 先固定稳定排序基准 #

• 每个聊天会话的JSON文件必须存储两个固定字段：
  • conv_id：全局唯一会话ID，生成后永不修改
  • last_msg_ts：会话最后一条消息的毫秒级时间戳，每次会话收到新消息时同步更新
• 列表统一排序规则：优先按last_msg_ts倒序排列，极端并发下如果两个会话时间戳完全一致，按conv_id字典序倒序做二级排序，保证全列表任意时刻的排序逻辑无歧义、无随机权重。

2. 调整分页请求参数 #

• 首次加载第一页时，前端无需传分页参数，服务端直接返回排序后列表的前10条，同时在返回结果中附带当前页最后一条条目的last_msg_ts和conv_id作为下一页的游标
• 前端触发加载更多时，不再传递last_id，而是传入上一页返回的两个游标参数：last_ts、last_conv_id

3. 服务端取数逻辑 #

• 每次请求先将全量会话按既定规则排序
• 非首页请求时，不查找索引位置，直接筛选满足以下任意条件的会话作为候选集：
  • 会话last_msg_ts小于传入的last_ts
  • 会话last_msg_ts等于传入的last_ts，且conv_id字典序小于传入的last_conv_id
• 从候选集中按顺序取前10条返回，同时附带这一页最后一条的游标参数供下一页请求使用

可直接复用的PHP实现代码 #

// 此处替换为实际业务逻辑：读取聊天目录下所有JSON文件，解析为会话数组
$convList = json_decode('[{"conv_id":"conv_001","last_msg_ts":1699999999123,"title":"工作群"},{"conv_id":"conv_002","last_msg_ts":1699999998456,"title":"客户咨询"},{"conv_id":"conv_003","last_msg_ts":1699999998456,"title":"朋友私聊"}]', true);

// 按固定规则排序
usort($convList, function($a, $b) {
    if ($a['last_msg_ts'] !== $b['last_msg_ts']) {
        return $b['last_msg_ts'] <=> $a['last_msg_ts'];
    }
    return $b['conv_id'] <=> $a['conv_id'];
});

// 接收分页游标参数
$lastTs = isset($_GET['last_ts']) ? intval($_GET['last_ts']) : 0;
$lastConvId = isset($_GET['last_conv_id']) ? trim($_GET['last_conv_id']) : '';
$isFirstPage = empty($lastTs) && empty($lastConvId);

$result = [];
foreach ($convList as $conv) {
    if (count($result) >= 10) break;
    if ($isFirstPage) {
        $result[] = $conv;
        continue;
    }
    // 过滤掉游标位置之前（更新时间更晚、已经加载过）的会话
    if (
        $conv['last_msg_ts'] < $lastTs 
        || ($conv['last_msg_ts'] == $lastTs && strcmp($conv['conv_id'], $lastConvId) < 0)
    ) {
        $result[] = $conv;
    }
}

// 组装返回结构
$response = [
    'list' => $result,
    'is_end' => count($result) < 10,
    'next_cursor' => empty($result) ? null : [
        'last_ts' => end($result)['last_msg_ts'],
        'last_conv_id' => end($result)['conv_id']
    ]
];

echo json_encode($response);

优化提示 #

• 该方案完全不受列表动态排序影响：拉取分页间隙新增的置顶会话，last_msg_ts必然大于传入的游标时间，会被过滤逻辑直接排除，不会出现重复拉取已读条目、漏拉老条目的问题
• 时间戳必须用毫秒级，不要用秒级，减少同时间戳的会话数量，降低二级排序的匹配压力
• 如果单目录下JSON文件数量超过1000，每次全量读文件解析排序性能会明显下降，可以额外维护一个轻量索引文件（只存所有会话的conv_id和last_msg_ts），分页时先从索引中筛出目标10个会话的ID，再读取对应JSON文件拼接完整内容即可，分页逻辑无需调整
• 下拉刷新时直接清空前端存储的游标，重新请求第一页即可，无需特殊兼容

内容的提问来源于stack exchange，提问作者Stdugnd4ikbd