Strapi v4如何实现默认全量一级populate叠加按需深层关联？

要实现默认全量一级关联Populate，同时支持传入includes参数叠加深层关联，核心是避免直接覆盖默认Populate，而是将自定义深层配置合并到基础配置中，具体实现步骤如下：

实现思路 #

1. 默认场景：无includes参数时，直接使用populate: '*'全量加载一级关联/组件
2. 有includes参数时：
   • 解析includes字符串为嵌套的Populate对象（如author.roles,comments.author转成对应嵌套结构）
   • 通过模型元数据获取所有一级关联/组件字段，构建基础Populate对象（替代*，方便合并）
   • 递归合并基础配置与自定义深层配置，最终执行查询

代码实现（以Article模型为例） #

在对应模型的控制器文件（如src/api/article/controllers/article.js）中修改find方法：

module.exports = {
  async find(ctx) {
    const { includes } = ctx.query;
    let populateConfig = '*';

    if (includes) {
      // 1. 解析includes字符串为嵌套Populate对象
      const populateObj = {};
      includes.split(',').forEach(path => {
        const parts = path.split('.');
        let currentNode = populateObj;
        parts.forEach((key, index) => {
          if (index === parts.length - 1) {
            currentNode[key] = true;
          } else {
            currentNode[key] = currentNode[key] || {};
            currentNode = currentNode[key];
          }
        });
      });

      // 2. 从模型元数据构建一级关联的基础Populate对象
      const modelUID = 'api::article.article'; // 替换为你的模型UID
      const modelMeta = strapi.db.metadata.get(modelUID);
      const basePopulate = {};

      Object.keys(modelMeta.attributes).forEach(attrKey => {
        const attr = modelMeta.attributes[attrKey];
        // 匹配关联、组件、动态区域类型的字段
        if (['relation', 'component', 'dynamiczone'].includes(attr.type)) {
          basePopulate[attrKey] = true;
        }
      });

      // 3. 递归合并基础配置与自定义深层配置
      const mergePopulate = (target, source) => {
        for (const key in source) {
          if (typeof source[key] === 'object' && source[key] !== null && target[key]) {
            mergePopulate(target[key], source[key]);
          } else {
            target[key] = source[key];
          }
        }
        return target;
      };

      populateConfig = mergePopulate(basePopulate, populateObj);
    }

    // 执行查询，覆盖原query中的populate配置
    return await strapi.entityService.findMany('api::article.article', {
      ...ctx.query,
      populate: populateConfig,
    });
  },
};

关键说明 #

• 替换modelUID为你实际的模型标识（如api::post.post）
• 递归合并函数会保留基础的一级关联，同时叠加自定义的深层关联，不会覆盖原有配置
• 支持多路径的includes参数（用逗号分隔，如includes=author.roles,comments.author）

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