分页查询在后台管理系统、商品列表、日志流这类场景里几乎是标配。很多接口一开始用 `LIMIT 20 OFFSET 200` 这种写法，数据量小的时候没问题，但页码一深响应就明显变慢。原因不复杂：数据库为了跳过前面 N 行，仍然需要把这些行读出来再丢弃，OFFSET 越大，扫描和丢弃的成本越高。如果排序字段又没有合适的索引，还会叠加排序开销。最近把几个后台列表接口从 offset 分页改成基于游标的 keyset pagination，这里把改造中容易踩的坑和实际 SQL 写出来，包括复合排序、游标条件、索引设计以及 Node.js 侧如何封装稳定的 cursor。

先看一个典型的慢查询。假设有订单表 `orders`，后台按创建时间倒序翻页：

```sql
SELECT id, user_id, amount, created_at
FROM orders
WHERE status = 'paid'
ORDER BY created_at DESC
LIMIT 20 OFFSET 40000;
```

执行计划里大概率能看到 `Index Scan` 或 `Bitmap Heap Scan` 后面跟着大量行被过滤。`OFFSET 40000` 意味着前 40000 行虽然不返回，但依然参与扫描和排序。数据量到百万级后，深分页接口耗时从几十毫秒涨到几百毫秒很常见。

keyset pagination 的思路是记住上一页最后一行的排序值，下一页从该值之后继续取。对于 `created_at DESC` 单列排序：

```sql
SELECT id, user_id, amount, created_at
FROM orders
WHERE status = 'paid'
 AND created_at < '2024-05-01 12:00:00'
ORDER BY created_at DESC
LIMIT 20;
```

这样数据库可以直接定位到 `created_at` 小于游标值的位置，不需要丢弃前面的行。但 `created_at` 可能重复，重复值会导致翻页时漏行或重复行。解决办法是引入唯一列作为第二排序键，比如 `id`：

```sql
SELECT id, user_id, amount, created_at
FROM orders
WHERE status = 'paid'
 AND (created_at, id) < ('2024-05-01 12:00:00', 12345)
ORDER BY created_at DESC, id DESC
LIMIT 20;
```

PostgreSQL 支持行值比较，`(created_at, id) < (?, ?)` 等价于 `created_at < ? OR (created_at = ? AND id < ?)`，写法更简洁，也能用上复合索引。对应的索引要覆盖过滤条件和排序：

```sql
CREATE INDEX idx_orders_status_created_id
ON orders (status, created_at DESC, id DESC);
```

注意索引列顺序要和查询的等值条件、排序列对齐。`status` 是等值过滤放最前，后面跟排序列。如果业务里还有其他过滤条件，比如 `user_id`，需要根据选择性决定是否加入索引，不要盲目堆列。

Node.js 侧封装 cursor 时，不要把整个排序字段拼成字符串再解析，容易遇到时间格式和逗号问题。用 base64 编码 JSON 更稳：

```js
function encodeCursor(row) {
 return Buffer.from(
 JSON.stringify({ createdAt: row.created_at.toISOString(), id: row.id })
 ).toString('base64url');
}

function decodeCursor(cursor) {
 if (!cursor) return null;
 const raw = Buffer.from(cursor, 'base64url').toString('utf8');
 const parsed = JSON.parse(raw);
 return { createdAt: new Date(parsed.createdAt), id: parsed.id };
}
```

查询时根据是否有 cursor 动态拼条件。用参数化查询避免 SQL 注入，同时让数据库复用执行计划：

```js
async function listOrders({ status, cursor, limit = 20 }) {
 const params = [status];
 let where = 'status = $1';
 const decoded = decodeCursor(cursor);

 if (decoded) {
 params.push(decoded.createdAt, decoded.id);
 where += ` AND (created_at, id) < ($2, $3)`;
 }

 params.push(limit + 1);
 const sql = `
 SELECT id, user_id, amount, created_at
 FROM orders
 WHERE ${where}
 ORDER BY created_at DESC, id DESC
 LIMIT $${params.length}
 `;

 const { rows } = await pool.query(sql, params);
 const hasNext = rows.length > limit;
 const items = hasNext ? rows.slice(0, limit) : rows;
 const nextCursor = hasNext ? encodeCursor(items[items.length - 1]) : null;

 return { items, nextCursor };
}
```

多取一条 `limit + 1` 用来判断是否有下一页，比额外查一次 `COUNT(*)` 便宜很多。后台如果确实需要总数，可以单独走缓存或近似统计，不要每次列表都 count。

keyset pagination 不适合直接跳页。产品上如果必须支持“跳到第 50 页”，要么保留 offset 分页但限制最大页数，要么改成无限滚动或“加载更多”。实际改造时通常先分析访问日志，绝大多数用户只翻前几页，深分页往往是爬虫或异常调用，可以给 offset 设上限，把真正的深翻页交给导出任务。

还有一个容易忽略的点：排序字段更新会导致游标失效。比如按 `updated_at` 排序，某条记录在翻页过程中被修改，它的位置会移动，用户可能看到重复或遗漏。这不是 keyset 独有的问题，offset 分页同样存在，只是 keyset 对数据变化更敏感。对一致性要求高的列表，可以用快照时间或事务隔离级别控制，或者接受最终一致并在前端去重。

如果排序表达式不是简单列，比如 `ORDER BY lower(name)`，行值比较就用不上了，需要把表达式结果存成生成列并建索引：

```sql
ALTER TABLE users
ADD COLUMN name_lower text GENERATED ALWAYS AS (lower(name)) STORED;

CREATE INDEX idx_users_name_lower_id ON users (name_lower, id);
```

然后游标条件写成 `(name_lower, id) > ($1, $2)`。生成列在 PostgreSQL 12 之后支持 STORED，表达式固定时比较实用。

改完之后，深分页接口的响应时间不再随页码线性增长，翻到后面几页和第一页耗时接近。代价是接口不能再随意跳页，前端需要改成游标驱动。这个取舍在列表类场景里通常划算，尤其是数据量大、排序稳定的后台接口。

 推荐查看天气：http://www.tianqi323.com/joke/list-1599.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1600.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1601.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1602.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1603.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1604.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1605.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1606.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1607.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1608.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1609.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1610.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1611.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1612.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1613.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1614.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1615.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1616.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1617.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1618.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1619.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1620.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1621.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1622.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1623.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1624.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1625.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1626.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1627.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1628.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1629.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1630.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1631.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1632.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1633.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1634.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1635.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1636.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1637.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1638.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1639.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1640.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1641.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1642.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1643.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1644.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1645.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1646.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1647.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1648.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1649.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1650.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1651.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1652.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1653.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1654.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1655.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1656.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1657.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1658.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1659.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1660.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1661.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1662.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1663.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1664.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1665.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1666.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1667.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1668.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1669.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1670.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1671.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1672.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1673.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1674.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1675.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1676.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1677.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1678.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1679.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1680.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1681.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1682.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1683.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1684.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1685.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1686.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1687.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1688.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1689.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1690.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1691.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1692.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1693.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1694.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1695.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1696.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1697.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1698.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1699.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1700.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1701.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1702.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1703.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1704.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1705.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1706.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1707.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1708.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1709.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1710.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1711.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1712.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1713.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1714.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1715.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1716.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1717.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1718.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1719.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1720.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1721.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1722.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1723.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1724.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1725.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1726.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1727.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1728.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1729.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1730.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1731.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1732.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1733.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1734.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1735.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1736.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1737.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1738.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1739.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1740.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1741.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1742.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1743.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1744.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1745.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1746.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1747.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1748.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1749.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1750.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1751.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1752.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1753.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1754.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1755.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1756.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1757.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1758.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1759.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1760.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1761.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1762.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1763.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1764.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1765.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1766.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1767.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1768.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1769.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1770.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1771.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1772.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1773.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1774.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1775.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1776.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1777.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1778.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1779.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1780.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1781.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1782.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1783.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1784.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1785.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1786.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1787.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1788.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1789.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1790.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1791.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1792.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1793.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1794.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1795.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1796.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1797.html
 推荐查看天气：http://www.tianqi323.com/joke/list-1798.html

分页查询在后台管理系统、商品列表、日志流这类场景里几乎是标配。很多接口一开始用 LIMIT 20 OFFSET 200 这种写法，数据量小的时候没问题，但页码一深响应就明显变慢。原因不复杂：数据库为了跳过前面 N 行，仍然需要把这些行读出来再丢弃，OFFSET 越大，扫描和丢弃的成本越高。如果排序字段又没有合适的索引，还会叠加排序开销。最近把几个后台列表接口从 offset 分页改成基于游标的 keyset pagination，这里把改造中容易踩的坑和实际 SQL 写出来，包括复合排序、游标条件、索引设计以及 Node.js 侧如何封装稳定的 cursor。

PostgreSQL 中 LIMIT 与 OFFSET 分页为什么越翻越慢，以及 keyset pagination 的实际改造

分页查询在后台管理系统、商品列表、日志流这类场景里几乎是标配。很多接口一开始用 LIMIT 20 OFFSET 200 这种写法，数据量小的时候没问题，但页码一深响应就明显变慢。原因不复杂：数据库为了跳过前面 N 行，仍然需要把这些行读出来再丢弃，OFFSET 越大，扫描和丢弃的成本越高。如果排序字段又没有合适的索引，还会叠加排序开销。最近把几个后台列表接口从 offset 分页改成基于游标的 k

数据库

后端

分页查询深翻页性能优化指南：keyset pagination游标分页替代OFFSET方案，解决后台系统、商品列表等场景深分页变慢问题。详解复合排序、游标条件、索引设计与Node.js封装，通过行值比较避免数据漏读，提升百万级数据查询效率。

代码解释

PostgreSQL

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

PostgreSQL 中 LIMIT 与 OFFSET 分页为什么越翻越慢，以及 keyset pagination 的实际改造-腾讯云开发者社区-腾讯云

PostgreSQL 中 LIMIT 与 OFFSET 分页为什么越翻越慢，以及 keyset pagination 的实际改造

PostgreSQL 中 LIMIT 与 OFFSET 分页为什么越翻越慢，以及 keyset pagination 的实际改造

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐