Strapi V3自定义控制器中如何正确填充clinic.schedule字段？

解决方案 #

在Strapi v3中，手动指定populate参数时，必须通过对象格式的嵌套配置，显式声明关联模型内的组件字段，才能正确加载clinic.schedule数据。

基础填充（加载完整schedule组件）

await strapi.services.clinic_pages.findOne(ctx.query, {
  populate: {
    clinic: {
      populate: ['schedule']
    }
  }
});

细粒度字段控制（仅返回需要的字段）

如果需要精简各层级返回的字段，可以在对应层级添加fields选项：

await strapi.services.clinic_pages.findOne(ctx.query, {
  // 父模型(clinic_pages)需返回的字段
  fields: ['id', 'otherParentField'],
  populate: {
    clinic: {
      // Clinic模型需返回的字段
      fields: ['id', 'otherClinicField'],
      populate: {
        schedule: {
          // Schedule组件需返回的字段
          fields: ['day', 'time']
        }
      }
    }
  }
});

问题原因 #

Strapi v3的populate参数存在两种格式限制：

1. 数组格式：仅支持指定顶级关联字段（如['clinic']），无法识别深层嵌套的组件路径（如clinic.schedule），因此不会自动填充组件数据。
2. 对象格式：支持嵌套配置，能够明确指定关联模型内的组件字段，这是加载深层组件数据的唯一有效方式。

当不指定populate参数时，Strapi会使用默认规则自动加载关联模型的所有关联字段（包括组件）；但一旦手动指定populate，就必须显式声明所有需要加载的深层关联/组件。

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