如何在Strapi中为关联字段实现分页功能？

问题场景 #

我使用Strapi作为Web应用后端框架，遇到了关联字段的分页问题：现有Category和Article两个模型，一个Category可关联多个Article，需要对特定分类下的Article实现分页，但Strapi官方文档明确说明关联查询与分页操作无法直接结合。当前客户端代码如下：

const query = {
    populate: {
      articles: true // 这里需要实现分页，比如获取前10条或第2页的10条数据
    }
  };
  const queryToString = qs.stringify(query, { encode: false });
  const {
    data: { data: categories },
  } = await axiosApiInstance.get(
    `${BACKEND_BASE_URL}categories/${id}?${queryToString}`
  );

可行解决方案 #

1. 反向查询（推荐） #

直接查询Article模型，通过过滤条件关联到目标Category，同时在Article的查询上直接应用分页参数。这种方法完全符合Strapi REST API的设计逻辑，还能自动获取完整的分页元数据。

客户端代码示例：

const query = {
  filters: {
    category: { id: { $eq: id } } // 过滤出属于目标分类的文章
  },
  pagination: {
    page: 1, // 当前页码
    pageSize: 10 // 每页展示数量
  }
};
const queryToString = qs.stringify(query, { encode: false });
const { data: articles } = await axiosApiInstance.get(
  `${BACKEND_BASE_URL}articles?${queryToString}`
);

2. 自定义Category控制器 #

如果必须在获取Category详情的同时返回分页后的Article列表，可以自定义Category的控制器来实现：

1. 打开后端文件 ./src/api/category/controllers/category.js
2. 修改或新增findOne方法：

'use strict';

module.exports = {
  async findOne(ctx) {
    const { id } = ctx.params;
    // 获取分类基础信息
    const category = await strapi.db.query('api::category.category').findOne({
      where: { id },
      select: ['id', 'name'] // 按需选择分类字段
    });
    // 从请求参数中获取分页参数，默认值可自定义
    const { page = 1, pageSize = 10 } = ctx.query;
    // 获取分页后的文章列表
    const articles = await strapi.db.query('api::article.article').findMany({
      where: { category: { id } },
      pagination: { page, pageSize },
      populate: ['author'] // 按需关联文章的其他字段
    });
    // 获取该分类下的文章总数，用于分页计算
    const articleCount = await strapi.db.query('api::article.article').count({
      where: { category: { id } }
    });

    // 返回整合后的结果
    return {
      ...category,
      articles,
      pagination: {
        page: parseInt(page),
        pageSize: parseInt(pageSize),
        total: articleCount,
        pageCount: Math.ceil(articleCount / pageSize)
      }
    };
  }
};

客户端请求时携带分页参数：

const query = {
  page: 1,
  pageSize: 10
};
const queryToString = qs.stringify(query, { encode: false });
const { data: category } = await axiosApiInstance.get(
  `${BACKEND_BASE_URL}categories/${id}?${queryToString}`
);

3. 使用GraphQL API（若项目已启用） #

Strapi的GraphQL原生支持关联字段的分页操作，示例查询如下：

query GetCategoryWithPagedArticles($id: ID!, $page: Int!, $pageSize: Int!) {
  category(id: $id) {
    id
    name
    articles(pagination: { page: $page, pageSize: $pageSize }) {
      data {
        id
        title
        content
      }
      meta {
        pagination {
          total
          pageCount
          currentPage
          pageSize
        }
      }
    }
  }
}

可通过Apollo等GraphQL客户端发送该查询，并传入对应的id、page、pageSize参数即可获取分页后的关联数据。

内容的提问来源于stack exchange，提问作者Komeil Mehranfar