Drupal 中渲染节点时出现 HTML 标签嵌套混乱的解决方案

drupal 节点在后台编辑时 html 正常,但前台渲染后出现 `` 标签被重复转义(如 `href="https://www./link/6dd48261917201c0de8ab30c7c510bac"`),根本原因是输入格式中启用了“自动将 url 转为链接”过滤器,导致已写好的 html 链接被二次解析和编码。

该问题常见于使用富文本编辑器(如 CKEditor)手动编写含 、 等内联样式的 HTML 内容时。Drupal 默认启用的「Convert URLs into links」过滤器会扫描纯文本中的 URL(如 http://myurl.com)并自动包裹成 标签;但当字段中已存在合法 HTML(例如 CLICK TO WATCH)时,该过滤器会错误地将 href="http://myurl.com" 中的 URL 再次识别为纯文本,并对引号、尖括号等字符进行 HTML 实体编码(如 " → ",

解决方法:禁用冲突的过滤器

  1. 进入管理后台:Admin → Configuration → Content authoring → Text formats and editors(Drupal 8/9/10 路径;Drupal 7 为 Administer → Configuration → Content authoring → Input formats
  2. 找到当前内容类型或字段所使用的文本格式(如 Full HTML、Basic HTML 或自定义格式),点击其右侧的 Configure(或 Edit)按钮
  3. 在「Enabled filters」列表中,取消勾选 “Convert URLs into links”(对应机器名通常为 filter_url)
  4. 滚动到底部,点击 Save configuration

⚠️ 注意事项:

  • 修改后必须清空所有缓存(包括页面缓存、动态页面缓存、Render cache 和 Twig 缓存),推荐执行 drush cr 或通过后台 Admin → Configuration → Development → Performance → Clear all caches
  • 若需保留自动链接功能(如用户提交纯文本评论时自动转链接),建议为不同用途创建独立文本格式:例如 Full HTML (No Auto-Link) 供内容编辑员使用,Plain Text (Auto-Link) 供用户表单使用,避免功能耦合
  • 不要依赖数据库直接修改字段值来“修复”——因问题源于渲染时的过滤器逻辑,而非存储内容本身;原始 HTML 在数据库中通常是正确的

? 补充验证:
可在 Twig 模板中临时添加调试输出确认过滤效果:

{# node.html.twig #}
{{ content.body|render|raw }} {# 绕过默认过滤,直出原始渲染结果(仅用于诊断!生产环境慎用) #}

但正式解决方案始终是调整输入格式配置,而非绕过安全过滤。

总结:Drupal 的文本过滤机制设计初衷是保障安全与易用性,但多重过滤叠加易引发意外交互。精准控制每种格式启用的过滤器,是构建稳定、可预测内容渲染体验的关键实践。