如何解决Strapi中‘likes组件与实体不关联’的更新错误？

问题场景 #

开发Strapi帖子点赞接口时，先查询获取帖子的现有点赞记录，用push添加新条目后调用entityService.update更新likes字段，报错提示"Some of the provided components in likes are not related to the entity"，但手动在内容管理器添加相同记录可正常生效。

原代码流程：

1. 查询现有点赞记录：

const likes = await strapi.db.query("api::post.post").findOne({
  where: {id: postId},
  populate: ["likes"]
});

返回数据示例：

[
  { id: 8, no_of_likes: 21 },
  { id: 10, no_of_likes: 13 },
  { id: 11, no_of_likes: 16 }
]

2. 添加新条目：

const likesJsonObject = [...likes.likes, { id: 2, no_of_likes: 22 }];

3. 更新数据库：

const entry = await strapi.entityService.update("api::post.post", postId, {
  data: {
    likes: likesJsonObject
  }
});

报错原因 #

likes是Strapi的重复组件（Repeatable Component），手动拼接数组时新添加的条目缺少组件类型标识__component，Strapi无法识别该条目属于当前实体的有效组件，因此抛出关联错误。手动添加时，内容管理器会自动为组件填充__component字段，所以可以正常生效。

解决方法 #

方法一：增量添加组件（推荐） #

无需查询现有组件，直接通过push操作向likes字段添加新条目，Strapi会自动处理组件关联：

const entry = await strapi.entityService.update("api::post.post", postId, {
  data: {
    likes: {
      push: {
        id: 2, // 替换为实际用户ID
        no_of_likes: 22 // 点赞数，可根据业务逻辑设置
      }
    }
  }
});

方法二：全量更新组件数组 #

如果必须先获取现有组件再更新，需确保每个条目都包含__component字段（组件的UID，可在Strapi后台组件设置中查看）：

1. 查询完整的组件数据（包含__component）：

const post = await strapi.db.query("api::post.post").findOne({
  where: { id: postId },
  populate: ["likes"]
});

2. 构造包含__component的更新数组：

// 替换"post.like"为你的组件实际UID，比如"api::post.like"
const updatedLikes = [...post.likes, {
  __component: "post.like",
  id: 2,
  no_of_likes: 22
}];

3. 执行更新：

const entry = await strapi.entityService.update("api::post.post", postId, {
  data: {
    likes: updatedLikes
  }
});

额外注意 #

• 确认likes组件的字段名是否正确，比如用户ID对应的字段如果是user_id而非id，需调整代码中的字段名。
• 如果likes是用户关联字段（而非组件），则应使用关联字段的更新方式（比如connect操作），但根据报错提示，当前场景属于组件类型，因此优先采用上述组件更新方案。

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