KeySet分页比Skip()+Take()快，因其用排序字段值过滤（如WHERE Id > @lastId）避免数据库全表扫描，而后者生成OFFSET需跳过前N行；要求排序字段有覆盖索引、单调无重复，适用于后台列表等场景，不支持任意页跳转。
KeySet分页为什么比 Skip()+Take() 快得多
因为 Skip(10000).Take(20) 会让 EF Core 生成 OFFSET 10000 ROWS，而数据库必须扫描并跳过前 10000 行——哪怕只取 20 条。KeySet 分页不依赖行号，而是用排序字段的值做条件过滤，比如 WHERE Id > @lastId ORDER BY Id LIMIT 20，数据库能直接走索引定位，避免全扫描。
关键前提是：排序字段必须有**覆盖索引**（例如 CREATE INDEX IX_Users_Id ON Users (Id)），且该字段在查询中是**单调递增/递减、无重复**的（如自增主键或带唯一约束的时间戳）。
- 适用场景：后台列表、无限滚动、API 分页接口（尤其是页码靠后或总记录数超百万）
- 不适用场景：需要跳转任意页码（如输入“第 842 页”）、排序字段含大量重复值（如按 Status 分页）
- 注意：必须保证客户端传回上一页最后一条记录的排序字段值（如
lastId），不能只传页码
怎么写一个安全的 KeySet 分页查询（EF Core）
核心是把 Skip() 换成 Where() + 显式参数，再配合 AsNoTracking()：
var lastId = 12345; // 上一页最后一条的 Id var pageSize = 20; <p>var nextBatch = await context.Users .AsNoTracking() .Where(u => u.Id > lastId) // 关键：用值过滤，不是跳行 .OrderBy(u => u.Id) .Take(pageSize) .ToListAsync();
如果要支持「上一页」，就改成 u.Id 并倒序查（<code>OrderByDescending），再反转结果；或者统一用正序 + TakeLast()（EF Core 8+ 支持）。
- 必须加
AsNoTracking()：分页只读，不跟踪实体可省掉变更追踪开销，实测快 30%~50% - 不能漏
OrderBy：没明确排序，数据库返回顺序不确定，KeySet 就会错乱 - 参数必须用变量（而非字面量），否则 EF 可能无法参数化，引发 SQL 注入或执行计划缓存失效
MySQL / PostgreSQL 怎么手写 KeySet 分页 SQL
绕过 EF 直接发 SQL 更可控，尤其当排序字段是复合字段（如 CreatedAt DESC, Id DESC）时：
-- MySQL 8.0+ SELECT * FROM Users WHERE (CreatedAt, Id) < (@lastCreatedAt, @lastId) ORDER BY CreatedAt DESC, Id DESC LIMIT 20;
-- PostgreSQL（支持行值比较） SELECT * FROM Users WHERE (CreatedAt, Id) < ($1, $2) ORDER BY CreatedAt DESC, Id DESC LIMIT 20;
SQL Server 不原生支持行值比较，得拆成 AND 条件：
-- SQL Server SELECT TOP 20 * FROM Users WHERE CreatedAt < @lastCreatedAt OR (CreatedAt = @lastCreatedAt AND Id < @lastId) ORDER BY CreatedAt DESC, Id DESC;
- 注意括号优先级：多个字段比较必须严格按排序方向对齐（升序用 ）
- 所有参与排序的字段都得建联合索引，顺序和
ORDER BY一致，例如IX_Users_CreatedAt_Id - 避免在 WHERE 中用函数（如
DATE(CreatedAt)），否则索引失效
KeySet 分页容易踩的三个坑
最常出问题的地方不在代码，而在数据语义和边界处理：
-
重复排序值没处理：比如按
Status分页，多个用户状态相同，WHERE Status > @lastStatus会漏掉同状态的其他记录。解法：补一个唯一字段（如Id）组成复合条件：WHERE (Status, Id) > (@lastStatus, @lastId) -
客户端传错 last 值：比如上一页最后一条是
Id=100，但前端误传lastId=99，结果跳过一条。建议服务端校验：查出第一条的Id，和传入lastId对比，偏差过大则报错 - 数据实时写入干扰分页：分页过程中新记录插入到「中间位置」（如按时间排序，新记录时间落在上一页末尾和本页开头之间），会导致某条记录被跳过或重复。这是 KeySet 的固有限制，无法完全规避，只能接受「最终一致性」或改用游标（cursor）+ 时间窗口兜底
真正难的不是写出 KeySet 查询，而是想清楚你的排序字段是否稳定、客户端能否可靠传递游标值、以及业务能否容忍少量数据偏移。
