Strapi v5导入脚本问题：如何设置条目为已发布并避免重复？

问题根源 #

1. 开启draftAndPublish后，Strapi会为文档维护草稿版和已发布版两个独立实例。如果导入时仅更新草稿但未正确触发发布流程，手动在UI发布时会生成新的已发布版本，看起来像重复条目。
2. 手动设置publishedAt并在update中传publish: true的方式不符合Strapi v5的文档发布逻辑，导致字段未被正确更新。
3. 未验证user参数的有效性，可能导致updated_by_id字段无值。

修复方案 #

方案1：直接创建并发布新文档（推荐用于全新导入） #

如果是导入全新产品，不要先创建草稿再更新，直接在创建时触发发布：

await strapi.documents('api::product.product').create({
  data: { ...data },
  publish: true, // 直接创建已发布版本
  user: strapi.admin.services.user.findOne({ id: 1 }) // 使用系统管理员用户，或合法的用户对象
});

• 无需手动设置publishedAt，Strapi会在发布时自动填充该字段。
• 确保user是有效的Strapi用户（比如系统管理员），否则updated_by_id会为空。

方案2：更新现有草稿并发布 #

如果是基于已存在的草稿更新并发布，需分两步操作：

// 第一步：更新草稿内容
await strapi.documents('api::product.product').update({
  documentId: documentId,
  data: { ...data },
  user: strapi.admin.services.user.findOne({ id: 1 })
});

// 第二步：触发发布流程，生成已发布版本
await strapi.documents('api::product.product').publish({
  documentId: documentId,
  user: strapi.admin.services.user.findOne({ id: 1 })
});

• publish方法会自动设置publishedAt字段，并将草稿版本转为已发布状态，避免手动发布时产生重复。

额外检查项 #

1. 确认路由的auth: false配置是否必要：如果导入脚本在服务器端运行，建议启用auth并使用服务账号，避免权限问题导致字段更新失败。
2. 检查集合类型的权限配置：确保操作文档的用户拥有publish权限。

内容的提问来源于stack exchange，提问作者donny.dee