EF Core 实现分页查询最常用、最直接的方式就是用
Skip()和
Take()方法,但要注意:必须配合
OrderBy()(或
OrderByDescending())使用,否则结果不稳定,甚至可能报错(尤其在 SQL Server 等数据库中启用了严格排序要求时)。
为什么必须加 OrderBy?
关系型数据库不保证无序查询的行顺序。跳过前 N 行时,若没有明确排序依据,每次执行
Skip(10).Take(5)可能返回不同数据,甚至重复或遗漏。EF Core 在生成 SQL 时,也会将
ORDER BY作为
OFFSET-FETCH(SQL Server)或
LIMIT-OFFSET(PostgreSQL/MySQL)的前提。
基础分页写法(推荐)
假设你要查第 3 页、每页 10 条(即跳过 20 条,取 10 条):
var pageNumber = 3; var pageSize = 10; <p>var pagedData = await context.Products .OrderBy(p => p.Id) // 必须有!建议用主键或有索引的字段 .Skip((pageNumber - 1) * pageSize) .Take(pageSize) .ToListAsync();
带条件和总数的完整分页(常用场景)
实际项目中常需「当前页数据 + 总条数」用于前端分页控件。注意:不能直接在同一个查询链里用
Count()+
Skip().Take(),因为会触发两次数据库查询(但这是合理且推荐的做法): 先查总数(可加相同 Where 条件) 再查分页数据(同样加 Where 和 OrderBy)
var keyword = "laptop";
var pageNumber = 2;
var pageSize = 15;
<p>// 1. 获取总数量(支持带搜索条件)
var totalCount = await context.Products
.Where(p => p.Name.Contains(keyword))
.CountAsync();</p><p>// 2. 获取当前页数据
var items = await context.Products
.Where(p => p.Name.Contains(keyword))
.OrderBy(p => p.Id)
.Skip((pageNumber - 1) * pageSize)
.Take(pageSize)
.ToListAsync();</p><p>// 组装分页结果(例如返回给 API)
var result = new
{
TotalCount = totalCount,
PageNumber = pageNumber,
PageSize = pageSize,
Items = items
};
性能注意点
大偏移量(如
Skip(100000))在深分页时性能会下降,因为数据库仍要扫描前 10 万行。优化建议: 限制最大页码(如只允许查前 1000 页) 改用「游标分页(Cursor-based Pagination)」:基于上一页最后一条记录的排序字段值继续查(如
WHERE Id > lastId ORDER BY Id LIMIT 10),适合无限滚动场景 确保
OrderBy字段有数据库索引(尤其是组合查询时)
基本上就这些。Skip/Take 分页简单直接,只要记住加 OrderBy、注意深分页性能,就能稳定用好。
