组件和动态区域应使用详细联表加载策略(on 片段)进行联表加载

页面摘要: 在 Strapi 5 中,组件和动态区域必须使用 on 片段显式联表加载,而非 v4 中支持的共享联表加载策略。

在 Strapi 5 中,组件和动态区域应使用带有 on 片段的详细联表加载策略进行联表加载。Strapi v4 中可行的共享联表加载策略不再受支持。

本页面是破坏性变更数据库的一部分,提供有关该破坏性变更的信息,以及从 Strapi v4 迁移到 Strapi 5 的附加说明。

破坏性变更说明

在 Strapi v4 中

在 REST API 调用中,你可以同时使用 共享或详细联表加载策略 来联表加载组件和动态区域。

在 Strapi 5 中

你必须使用 on 片段来显式指明要 联表加载 哪些组件和动态区域。

迁移

本节汇总了关于该破坏性变更的有用说明和操作步骤。

说明

有关联表加载的更多信息,可在 REST API 文档 中找到。

手动操作步骤

用户应确保组件和动态区域使用 on 片段显式联表加载,例如以下示例语法和 URL:

  • 通用语法示例:

    populate[dynamic-zone-name][on][component-category.component-name]=true

  • URL 示例:

    /api/articles?populate[dynamic-zone-name][on][component-category.component-name]=true