Drupal 9中Gutenberg编辑器模块不显示问题求助

1. 确认内容类型编辑器配置 #

• 进入结构 > 内容类型，点击对应内容类型的「管理表单显示」
• 检查「正文」字段是否已设置为Gutenberg编辑器，而非默认的「文本格式」或其他编辑器
• 确保该字段的「显示」状态为启用（未被隐藏）

2. 检查用户权限 #

• 进入人员 > 权限，核对Gutenberg相关权限：
  • 确认当前编辑用户拥有「使用Gutenberg编辑器」权限
  • 同时需确保用户拥有对应内容类型的「创建/编辑」权限，以及「使用目标文本格式（如富文本）」的权限

3. 清除缓存与前端资源 #

• 执行Drupal缓存清除：进入配置 > 性能，点击「清除所有缓存」；或使用Drush命令：drush cr
• 强制刷新浏览器页面（Ctrl+F5/Command+Shift+R），避免前端加载旧资源
• 若使用CDN或服务器缓存，同步清除对应缓存

4. 排查模块冲突 #

• 暂时禁用其他编辑器类模块（如CKEditor 5、TinyMCE等），多编辑器模块易产生冲突
• 逐个禁用非核心模块，测试是否有模块与Gutenberg存在兼容性问题
• 查看报告 > 最近的日志消息，搜索Gutenberg相关的JS/PHP错误提示

5. 验证版本兼容性 #

• 确认Gutenberg模块版本与Drupal 9的兼容匹配（参考模块官方兼容说明）
• 若为社区贡献模块，更新至最新稳定版本，修复已知兼容性bug

6. 检查主题支持 #

• 切换至Drupal核心主题（如Bartik、Claro）测试编辑器是否显示，排查自定义主题适配问题
• 若切换核心主题后正常，需在自定义主题的.info.yml中添加Gutenberg支持：libraries: - gutenberg/drupal.gutenberg.editor，同时确保主题未覆盖编辑器渲染逻辑

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