如何在MongoDB与Node.js中正确实现Mongoose Paginate分页？

一、核心问题排查 #

• 检查skip和limit参数传递逻辑：确保Controller-main.js将前端传入的分页参数（如page、pageSize）正确转换为skip=(page-1)*pageSize、limit=pageSize，并完整传递给controller-search.js，避免硬编码固定值导致仅返回4条数据。
• 确认是否返回总记录数：分页组件依赖总条数计算总页数，若仅返回当前页的ID列表，前端无法生成分页选项。

二、正确的分页实现步骤 #

1. 改造controller-search.js：同时返回数据与分页元信息 #

不要只返回查询到的ID，需并行执行数据查询和总条数统计，将两者结果一并返回：

// controller-search.js
async function searchDocuments(queryParams) {
  // 解构分页参数，设置默认值
  const { page = 1, pageSize = 10, ...filters } = queryParams;
  const skip = (page - 1) * pageSize;
  const limit = parseInt(pageSize);

  // 并行执行查询和计数，提升性能
  const [docList, totalCount] = await Promise.all([
    // 查询当前页的ID列表
    YourModel.find(filters).select('_id').skip(skip).limit(limit).lean(),
    // 统计符合条件的总记录数
    YourModel.countDocuments(filters)
  ]);

  return {
    ids: docList.map(item => item._id),
    pagination: {
      currentPage: page,
      pageSize,
      total: totalCount,
      totalPages: Math.ceil(totalCount / pageSize)
    }
  };
}

2. 优化Controller-main.js：正确传递参数并响应完整结果 #

确保从请求中正确提取分页参数，传递给查询控制器后，将包含分页信息的结果返回给前端：

// Controller-main.js
async function handleSearch(req, res) {
  try {
    // 从请求参数中获取分页值，做类型转换和默认值兜底
    const page = parseInt(req.query.page) || 1;
    const pageSize = parseInt(req.query.pageSize) || 10;
    // 提取其他业务查询条件
    const filters = { /* 从req中解析的过滤条件 */ };

    // 调用查询控制器
    const searchResult = await searchDocuments({ ...filters, page, pageSize });

    // 返回带分页信息的响应
    res.status(200).json({
      success: true,
      ids: searchResult.ids,
      pagination: searchResult.pagination
    });
  } catch (err) {
    res.status(500).json({ success: false, message: err.message });
  }
}

3. 前端适配（关键） #

前端需利用返回的total和totalPages渲染分页组件：

• 根据totalPages生成分页按钮组
• 切换页码时，将对应的page参数传递给后端接口

三、常见坑点规避 #

• 避免硬编码分页参数：skip和limit必须从请求中动态获取，禁止写死固定值。
• 强制类型转换：URL参数默认是字符串，需转成数字后再计算skip，否则会出现逻辑错误。
• 保持过滤条件一致：countDocuments的过滤条件必须和find完全相同，否则总条数统计不准，导致分页逻辑混乱。

内容的提问来源于stack exchange，提问作者Utsav Upadhyay