Drupal中Twig模板内联CSS在邮件通讯中失效问题

1. 确认模板是否正确加载 #

• 先验证模板是否生效：在simplenews-newsletter-body--default.html.twig里加一句测试注释<!-- TEST TEMPLATE ACTIVE -->，发送测试邮件后查看邮件源码。如果看不到这句，说明模板没被正确应用——可能是命名不对（比如应该用期刊机器名命名：simplenews-newsletter-body--test1-newsletter.html.twig），或者当前主题权重不足，没覆盖默认模板。

2. 检查内联CSS过滤器的核心配置 #

• 确保已安装并启用inline_css contrib模块，然后在settings.php里确认对应文本格式的过滤器状态：

  // 替换为你通讯使用的文本格式，比如full_html
  $config['filter.format.full_html']['filters']['inline_css']['status'] = TRUE;
  

• 进入Simplenews期刊设置页，确认期刊使用的文本格式已经启用了inline_css过滤器，比如Full HTML格式。如果用的是Basic HTML这类默认格式，大概率没开这个过滤器。

3. 验证{% apply inline_css %}的语法正确性 #

• 确保CSS代码完整包裹在标签对之间，写法规范：

  {% apply inline_css %}
    <style>
      h1 { color: #ff0000; font-size: 24px; }
      .news-item { padding: 15px; }
    </style>
    <h1>测试通讯标题</h1>
    <div class="news-item">正文内容</div>
  {% endapply %}
  

• 发送后查看邮件源码：正常情况下，<style>标签会被处理成内联style属性，比如<h1 style="color: #ff0000; font-size: 24px;">。如果源码里还保留<style>标签，说明过滤器完全没触发。

4. 排查邮件渲染流程干扰 #

• 临时禁用其他邮件相关模块（比如Mime Mail），测试样式是否生效——部分第三方模块可能拦截了Simplenews的渲染管道，导致内联CSS过滤器失效。
• 每次修改模板或配置后，必须清空Drupal所有缓存（配置缓存、渲染缓存），否则旧的缓存内容会覆盖新设置。

5. H1标签失效的额外排查点 #

• 部分邮件客户端会重置标题标签的默认样式，即使内联CSS也可能被覆盖。可以给H1加更具体的内联样式，或者用<span style="...">包裹标题文本测试。
• 检查文本格式的过滤器：如果启用了“限制HTML标签”或“转换为纯文本”类过滤器，H1标签可能被过滤成普通文本或<p>标签，需要确保文本格式允许H1标签存在。

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