EF Core怎么实现分页查询 EF Core Skip和Take分页方法

来源:这里教程网 时间:2026-02-21 17:35:04 作者:

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、注意深分页性能,就能稳定用好。

相关推荐