MongoDB.Driver C#字母排序后Skip/Take返回结果位置异常问题

问题背景 #

在C#项目中使用MongoDB.Driver 2.19.1版本，针对如下模型设计的集合进行好友列表查询：

public class UserFriend
{
    [BsonId]
    [BsonRepresentation(BsonType.ObjectId)]
    public string Id { get; set; }

    public List<FriendInfo> Friends { get; set; }

    public List<FriendInvite> FriendInvites { get; set; }
}

public class FriendInfo
{
    public string UserId { get; set; }

    public string FirstCharName { get; set; }

    public string Email { get; set; }

    public string FullName { get; set; }

    public string Avatar { get; set; }

    public DateTime FriendDay { get; set; }
}

public class FriendInvite
{
    public string Sender { get; set; }

    public string Email { get; set; }

    public string Introduction { get; set; }

    public string FullName { get; set; }

    public string CharName { get; set; }

    public string Avatar { get; set; }

    public DateTime Time { get; set; }
}

全量查询指定用户的好友并按FirstCharName排序时结果正常：

var listall = await _userFriendsCollection.Aggregate()
                                .Match(x => x.Id == userId)
                                .Unwind<UserFriend>(new StringFieldDefinition<UserFriend>("Friends"))
                                .ReplaceRoot<FriendInfo>(new BsonValueAggregateExpressionDefinition<UserFriend, FriendInfo>(@"$Friends"))
                                .SortBy(o => o.FirstCharName)
                                .ToListAsync();

但使用Skip(10)+Limit(10)分页时，本该返回第11-20条数据，实际结果却包含第21条，出现数据错位。

核心原因 #

问题出在排序字段的唯一性不足：当多个FriendInfo的FirstCharName值相同时，MongoDB的Sort操作无法保证这些数据的固定顺序。全量查询时，相同值的条目顺序可能与分页查询时不一致，导致Skip和Limit的截取位置出错，出现数据错位。

例如，若第10、11、20、21条数据的FirstCharName均为"A"，全量查询时顺序为[10,11,20,21]，但分页查询时MongoDB可能对这些条目重新排序，导致Skip(10)后截取到[21,...]而非预期的[20,...]。

解决方案 #

给排序操作添加唯一兜底排序字段，确保整体排序的稳定性。可以选择FriendInfo中唯一的字段（如UserId），或能保证相同FirstCharName条目顺序固定的字段（如FriendDay）。

修改后的分页查询代码：

var limit = await _userFriendsCollection.Aggregate()
                                        .Match(x => x.Id == userId)
                                        .Unwind(x => x.Friends) // 改用强类型写法避免硬编码
                                        .ReplaceRoot(x => x.Friends)
                                        .SortBy(o => o.FirstCharName)
                                        .ThenBy(o => o.UserId) // 添加唯一兜底排序字段
                                        .Skip(skip)
                                        .Limit(take)
                                        .ToListAsync();

验证建议 #

1. 检查全量结果集中FirstCharName相同的条目数量，确认是否存在大量重复值的情况。
2. 执行修改后的分页查询，对比全量数据的手动分页结果，验证错位问题是否解决。

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