Sulu技术问题：如何为PageDocument索引全部内容？

我碰到过好几个Sulu用户遇到类似的问题——后台发布文章后，搜索索引里就是看不到body内容，排查下来都是ObjectToDocumentConverter生成的AppBundle\Search\Document里contentFields为空导致的。下面是一步步的排查和解决方法：

• 第一步：检查Content类型的搜索字段配置
  Sulu的内容要被纳入索引，必须在对应的Content Type配置里明确标记字段为可搜索。打开你的文章Content Type配置文件（通常在config/packages/sulu_content.yaml或者src/AppBundle/Resources/config/content-types下的yaml文件），找到body字段的配置块，确保添加了searchable: true属性。示例配置如下：

  properties:
    body:
      type: text_editor
      searchable: true
      # 其他字段配置...
  

  这个配置是告诉Sulu，该字段需要被纳入搜索索引的内容范围，是基础前提。

• 第二步：验证ObjectToDocumentConverter的字段映射逻辑
  默认情况下，Sulu的ObjectToDocumentConverter会自动收集所有标记了searchable: true的字段值，但如果你的项目有自定义的Converter实现，可能覆盖了这个默认逻辑。
  如果使用的是默认Converter，可以在调试时打印内容对象的字段值，确认body字段确实有有效内容——有时候问题出在内容保存阶段，body字段没有被正确持久化，导致Converter拿不到值。如果是自定义Converter，检查代码是否正确读取了body字段并将其加入到contentFields数组中。

• 第三步：排查事件订阅者是否干扰了转换过程
  Sulu在搜索文档转换的前后会触发特定事件，比如SearchEvents::OBJECT_TO_DOCUMENT和SearchEvents::DOCUMENT_TO_OBJECT。如果项目中存在自定义的事件订阅者监听了这些事件，可能不小心清空了contentFields数组。检查这些订阅者的代码，确保它们没有修改contentFields的内容，或者正确地将body字段值添加了进去。

• 第四步：手动触发索引更新
  就算配置改对了，已经发布的旧文章也不会自动重新索引。你可以通过命令行手动触发全量索引更新：

  php bin/console sulu:search:reindex
  

  这个命令会重新处理所有可索引的内容，把正确的body字段内容写入到搜索索引中。

如果以上步骤都没解决问题，建议开启Sulu的调试日志，查看ObjectToDocumentConverter转换过程中的日志输出，里面可能会有字段被跳过或者报错的信息，帮你定位到具体的问题点。

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