Drupal 8.6.17嵌入实体不显示问题排查求助（已装Embed及Media Gallery）

根据你描述的操作和遇到的问题，已经完成了基础的CKEditor与实体标签配置，但前端仍无法渲染<drupal-entity>标签对应的媒体内容，建议从以下几个方向逐一排查：

• 检查实体嵌入显示模式的有效性
  你当前使用的data-entity-embed-display值是entity_reference:entity_reference_entity_id，这个显示模式的默认行为是仅输出实体ID，而非渲染实体内容。你需要：

  1. 进入结构 > 媒体类型 > [你的媒体类型] > 显示模式，确认存在适合的显示模式（比如media_thumbnail或自定义显示模式），且该模式下已启用并正确配置了图片字段（例如设置为显示指定的图片样式）。
  2. 在实体嵌入按钮（assets）的配置中，将默认显示模式切换为上述有效的渲染模式；对于已存在的内容，可以手动修改data-entity-embed-display属性为正确的模式值，比如media:media_thumbnail。

• 验证文本格式的过滤器配置
  除了添加<drupal-entity data-*>到允许标签列表，还要确认：

  1. Entity Embed过滤器已在对应文本格式中启用，且过滤器顺序正确（Entity Embed过滤器应在HTML过滤器之后执行，避免标签被转义）。
  2. HTML过滤器的“允许的HTML标签”中，确保<drupal-entity>的所有data-*属性都被允许，建议直接写为<drupal-entity data-*>，避免遗漏必要属性。

• 确认媒体实体的状态与权限

  1. 通过UUID（e9884625-791a-4362-92f7-0c56c9b928c3）在后台查找对应的Media实体，检查它是否已发布、是否存在（未被删除），且关联的图片文件未损坏或被删除。
  2. 确认当前访问前端的用户角色（比如匿名用户）拥有查看该媒体实体的权限，进入人员 > 权限，找到对应媒体类型的“查看已发布媒体”权限并启用。

• 检查缓存与前端控制台

  1. 清除Drupal的所有缓存（配置缓存、页面缓存、渲染缓存等），很多配置修改需要清除缓存才会生效。
  2. 打开浏览器开发者工具的控制台，查看是否有JavaScript错误或资源加载失败的情况，部分JS冲突可能会间接影响实体渲染。

• 验证CKEditor按钮的配置
  回到CKEditor的配置页面，确认assets嵌入按钮的设置：

  • 实体类型选择的是Media
  • 默认显示模式已设置为有效的渲染模式（而非仅输出ID的模式）
  • 按钮对应的目标媒体类型（比如图片）已被正确选中

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