新手求教：基于Express框架的Node.js+PostgreSQL API分页实现方法

嘿，作为Node.js新手能想到要做分页，这思路很到位！分页是API开发里的高频需求，结合Express和PostgreSQL其实没那么复杂，我一步步给你拆解清楚：

一、先搞懂分页的核心逻辑 #

分页依赖两个关键参数（一般由前端通过URL query传递）：

• page：当前要获取的页码，默认设为1就行
• limit：每页展示的数据条数，默认可以设10，也可以限制最大比如100，避免一次拉太多数据

然后计算数据库查询需要的偏移量：offset = (page - 1) * limit，这个用来告诉PostgreSQL从哪条数据开始查。

二、PostgreSQL的分页查询写法 #

PostgreSQL原生支持LIMIT和OFFSET语法，刚好对应分页需求。另外我们还需要查总数据条数，这样能给前端返回总页数、是否有下一页这些信息。

举个例子，假设你有一张products表，要分页查询商品数据：

1. 查询当前页数据：

SELECT * FROM products ORDER BY id ASC LIMIT $1 OFFSET $2;

这里的$1是limit，$2是计算好的offset，用占位符是为了防止SQL注入，一定要这么写！

2. 查询总数据条数：

SELECT COUNT(*) FROM products;

三、Express接口完整实现代码 #

先装依赖：

npm install express pg

然后写接口代码：

const express = require('express');
const { Pool } = require('pg');
const app = express();

// 配置PostgreSQL连接池（比单连接更高效）
const pool = new Pool({
  user: '你的数据库用户名',
  host: 'localhost', // 本地数据库就填这个
  database: '你的数据库名',
  password: '你的数据库密码',
  port: 5432, // PostgreSQL默认端口
});

// 分页获取商品列表的接口
app.get('/api/products', async (req, res) => {
  try {
    // 从URL query拿参数，给默认值避免前端不传
    const page = parseInt(req.query.page) || 1;
    const limit = parseInt(req.query.limit) || 10;

    // 计算偏移量
    const offset = (page - 1) * limit;

    // 1. 查询当前页的数据
    const dataQuery = await pool.query(
      'SELECT * FROM products ORDER BY id ASC LIMIT $1 OFFSET $2',
      [limit, offset]
    );

    // 2. 查询总数据条数
    const countQuery = await pool.query('SELECT COUNT(*) FROM products');
    const totalItems = parseInt(countQuery.rows[0].count);
    const totalPages = Math.ceil(totalItems / limit); // 总页数向上取整

    // 构造友好的响应给前端
    res.json({
      data: dataQuery.rows,
      pagination: {
        currentPage: page,
        pageSize: limit,
        totalItems: totalItems,
        totalPages: totalPages,
        hasNextPage: page < totalPages,
        hasPrevPage: page > 1
      }
    });
  } catch (err) {
    console.error('查询出错:', err);
    res.status(500).json({ error: '服务器内部错误，请稍后再试' });
  }
});

// 启动服务
app.listen(3000, () => {
  console.log('服务器跑在 http://localhost:3000 啦');
});

四、进阶优化建议 #

1. 参数验证 #

别直接信任前端传的参数！可以用express-validator校验page和limit必须是正整数：

npm install express-validator

修改接口代码：

const { query, validationResult } = require('express-validator');

app.get('/api/products', [
  // 校验page：可选，必须是>=1的整数
  query('page').optional().isInt({ min: 1 }).withMessage('page必须是大于等于1的整数'),
  // 校验limit：可选，必须是1-100之间的整数
  query('limit').optional().isInt({ min: 1, max: 100 }).withMessage('limit必须是1到100之间的整数')
], async (req, res) => {
  // 检查验证结果
  const errors = validationResult(req);
  if (!errors.isEmpty()) {
    return res.status(400).json({ errors: errors.array() });
  }

  // 后面的查询逻辑不变...
});

2. 大数据量下的性能优化 #

当你的表数据非常多（比如几十万、上百万条），OFFSET会让数据库扫描前面所有的行，性能会变慢。这时候可以用Keyset分页（也叫游标分页）：

// 滚动加载的接口，前端传上一页最后一条数据的id
app.get('/api/products/scroll', async (req, res) => {
  try {
    const limit = parseInt(req.query.limit) || 10;
    const lastId = parseInt(req.query.lastId) || 0; // 上一页最后一条的id，默认从0开始

    const result = await pool.query(
      'SELECT * FROM products WHERE id > $1 ORDER BY id ASC LIMIT $2',
      [lastId, limit]
    );

    res.json({
      data: result.rows,
      hasMore: result.rows.length === limit // 如果返回满limit条，说明还有更多数据
    });
  } catch (err) {
    console.error('查询出错:', err);
    res.status(500).json({ error: '服务器内部错误，请稍后再试' });
  }
});

这种方式适合滚动加载的场景（比如移动端下拉加载更多），但缺点是不能直接跳转到指定页码，你可以根据业务需求选择。

这样一套下来，基础的分页功能就搞定啦，要是有其他细节问题（比如关联表分页、自定义排序字段），随时问我！

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