Drupal v9环境下CKEditor工具栏已激活项目未正常显示问题
可能成因
- 缓存未失效:Drupal 9默认开启页面缓存、渲染缓存等多级缓存机制,后台调整工具栏配置后缓存没有及时更新,预览时加载的还是旧版本的页面结构。
- 权限配置错误:移动后的工具栏项目设置了特定的访问权限,预览时使用的用户角色没有对应查看权限,Drupal在渲染页面时会自动过滤无权限的元素。
- 主题适配问题:当前使用的自定义前端主题覆写了工具栏的渲染逻辑,没有适配调整后的工具栏配置,导致移动后的项目没有被渲染到前端页面。
- 核心版本bug:Drupal 9.2.x版本存在工具栏配置保存的已知bug,后台拖拽调整后的配置仅在当前会话临时生效,没有实际写入系统配置表,刷新或预览就会丢失。
解决方案
- 清空全站缓存:进入后台「配置」-「开发」-「性能」页面,点击「清除所有缓存」按钮即可,也可使用Drush命令
drush cr快速完成缓存清理,之后再预览测试。 - 校验权限配置:先切换为超级管理员(UID=1)账号预览,如果此时工具栏项目正常显示,就说明是权限配置问题,调整对应工具栏项目的访问权限,对应用户角色开放查看权限即可。
- 测试主题兼容性:暂时将站点前端主题切换为Drupal默认的Olivero或Bartik主题,预览查看工具栏是否正常显示,如果恢复正常就说明是自定义主题的适配问题,检查主题下
page.html.twig等模板中对工具栏的自定义代码,补充适配调整后的配置即可。 - 修复核心bug:可以直接将Drupal核心升级到9.3及以上版本修复该已知问题,如果暂时不能升级核心,也可以应用对应issue的官方补丁,之后重新保存工具栏配置即可永久生效。
内容的提问来源于stack exchange,提问作者Nguyễn Xuân Nghĩa
相关产品推荐
相关产品推荐

