Payload 3.0迁移外部CMS内容至Lexical编辑器：图片块插入实现咨询

看起来你正面临从外部CMS迁移内容到Payload 3.0 Lexical编辑器的挑战，特别是要处理带自定义图片块的富文本内容。我来帮你梳理一下实现思路和具体步骤：

你的环境与配置 #

首先明确你当前的技术栈和编辑器配置：

• 使用的包版本：

  • payloadcms: 3.0.0-beta.20
  • lexical: 0.14.5

• 你配置的Lexical编辑器特性：

const features = [
  HeadingFeature({ enabledHeadingSizes: ['h2', 'h3'] }),
  ParagraphFeature(),
  ItalicFeature(),
  BoldFeature(),
  OrderedListFeature(),
  UnorderedListFeature(),
  LinkFeature({ enabledCollections: [] }),
  BlocksFeature({
    blocks: [
      {
        slug: 'image',
        interfaceName: 'Image',
        fields: [
          {
            name: 'image',
            type: 'upload',
            relationTo: 'images',
            required: true,
          },
        ],
      },
    ],
  }),
];

• 集合中content富文本字段的配置：

{
  name: 'content',
  type: 'richText',
  required: true,
  editor: lexicalEditor({
    features: features // 关联上述配置的特性数组
  }),
}

核心迁移步骤（针对图片块） #

1. 先批量迁移外部图片到Payload的Images集合

Lexical的图片块依赖Payload的images集合存储图片资源，所以第一步必须把外部CMS里的所有图片文件先上传到这个集合中：

• 写一个批量上传脚本，遍历外部CMS的图片资源（可以通过API拉取或直接从原数据库导出）
• 调用Payload的文件上传API，或者直接操作数据库（比如MongoDB）创建图片文档
• 记录每个外部图片URL与对应的Payload图片文档ID的映射关系，后续转换富文本会用到

2. 将外部富文本转换为Lexical兼容的JSON结构

Lexical的富文本是以特定JSON格式存储的，你的自定义图片块需要转换成如下节点结构：

{
  "type": "block",
  "blockType": "image", // 对应你配置的block的slug
  "id": "唯一节点ID（建议用uuid生成）",
  "fields": {
    "image": "这里填对应的Payload图片文档ID" // 关联第一步上传的图片ID
  },
  "children": [
    {
      "type": "text",
      "text": ""
    }
  ]
}

• 注意：每个Lexical节点必须有唯一的id，可以用uuid库生成；自定义块必须包含一个空的文本子节点，这是Lexical的硬性要求
• 除了图片块，其他格式也要对应转换：比如外部的<h2>对应Lexical的heading节点（tag: 'h2'），有序列表对应list节点（listType: 'ordered'）等

3. 编写批量迁移脚本

整合上述步骤，写一个Node.js脚本完成全流程：

• 从外部CMS导出目标内容（Post/Work/Article）
• 遍历每篇内容，解析原富文本内容，提取图片元素并替换为Lexical图片块节点
• 调用Payload的create或updateAPI，把转换后的内容存入对应的集合

4. 测试与验证

先迁移少量内容到测试环境，登录Payload后台检查：

• 富文本编辑器中的图片是否正常显示
• 点击图片是否能正确关联到images集合的文档
• 如果出现显示异常，可以打开浏览器开发者工具，查看Lexical的JSON结构，对比正确格式调整转换逻辑

额外注意事项 #

• 因为你使用的是Payload 3.0的beta版本，部分API或节点格式可能有变动，建议结合官方的Lexical集成文档确认细节
• 脚本中要加入错误捕获机制，比如图片上传失败、内容转换出错的情况，方便排查问题
• 如果外部富文本有复杂格式（比如嵌套列表、混合样式），需要逐一对应转换为Lexical的节点类型

备注：内容来源于stack exchange，提问作者Deividas Šaltupis