Strapi如何在单个REST API端点中合并返回多个集合数据？

最省事的方案是做配置化的聚合自定义端点，核心逻辑只需要写一次，后续增删要合并的集合不需要改业务代码，维护成本接近零，完全适配你2个甚至10个以上小集合的合并需求。

实现步骤 #

1. 新建聚合接口路由 #

在项目中新建一个专门用来返回聚合全局数据的接口，路由文件路径为src/api/bundle/routes/bundle.js，代码如下：

module.exports = {
  routes: [
    {
      method: 'GET',
      path: '/site-bundle',
      handler: 'bundle.getAggregatedData',
      config: {
        auth: false, // 按需调整，是否需要登录鉴权
      },
    }
  ]
}

这个路由固定之后就不用再改了。

2. 编写可复用的聚合控制器 #

控制器文件路径为src/api/bundle/controllers/bundle.js，核心逻辑是把所有要合并的集合抽成独立配置项，循环调用Strapi原生查询方法组装结果，写完之后核心逻辑永远不用动：

module.exports = {
  async getAggregatedData(ctx) {
    // ========== 唯一需要维护的配置区 开始 ==========
    // 以后增删要合并的集合，只需要改这个数组就行
    const aggregateConfigs = [
      {
        key: 'menu', // 返回结果里的字段名
        contentType: 'api::menu.menu', // Strapi对应集合的全局唯一标识
        query: { populate: '*' } // 和默认REST API的查询参数写法完全一致，支持过滤、排序、字段选择
      },
      {
        key: 'posts',
        contentType: 'api::posts.posts',
        query: { populate: 'text' }
      },
      // 要加第3个、第10个集合，直接在数组后面追加配置项即可
      // 例：{ key: 'siteInfo', contentType: 'api::site-info.site-info', query: {} }
    ]
    // ========== 唯一需要维护的配置区 结束 ==========

    const mergedResult = {}
    for (const config of aggregateConfigs) {
      // 调用Strapi内置实体服务查询，返回数据结构和单个集合默认API完全一致
      mergedResult[config.key] = await strapi.entityService.findMany(
        config.contentType,
        config.query
      )
    }

    return ctx.send({ data: mergedResult })
  }
}

方案优势 #

• 维护成本极低：核心逻辑写完一次就不用动，后续加新集合只需要在配置数组里加1行配置，10秒就能搞定，完全不需要改路由、改核心查询逻辑
• 数据一致性高：所有查询走Strapi原生entityService，自动适配组件、关联字段填充、权限校验规则，和你单独调用每个集合默认API拿到的数据格式完全一致，不会出现格式偏差
• 性能更好：前端只需要发1次请求就能拿到所有需要的小数据，比并发调用10个独立接口减少了多次TCP连接开销，还可以直接给这个接口加内存缓存（比如缓存5-10分钟，小数据更新频率低），进一步降低数据库压力

避坑提醒 #

不要为了合并数据强行给独立集合加关联关系，再用默认API的populate参数拉取所有数据。这种方式会让原本独立的数据集产生不必要的耦合，后续修改数据结构时牵一发动全身，维护成本比自定义端点还高。

可选扩展 #

如果需要更高灵活度，可以给接口加可选参数：比如支持前端传?keys=menu,posts指定本次要拉取的集合，控制器里根据传入的key过滤配置项再查询即可，不需要额外写其他接口。

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