Drupal 8中Webform HTML邮件嵌入Logo图片问题求助

我之前做类似需求时也踩过这个坑，结合Mime Mail和Webform的特性，有几个亲测有效的方法可以解决邮件里Logo显示为空标签的问题，你可以根据自己的需求选择：

方法1：使用绝对URL引用Logo（最简单直接） #

邮件客户端大多不支持相对路径，直接用完整的绝对URL是最省心的方式：

• 如果你是引用站点默认Logo，可以在Twig模板里这么写：

  <img src="{{ url('file_download', {'file': file_load(config('system.site').get('logo.fid'))}) }}" alt="站点Logo">
  

• 也可以直接硬编码Logo的绝对路径（适合固定不变的Logo）：

  <img src="https://你的站点域名/sites/default/files/logo.png" alt="站点Logo">
  

⚠️ 注意：要确保Logo文件的权限是公开可访问的，不然邮件客户端会加载失败。

方法2：将Logo转为Base64嵌入（无外部请求） #

把图片转换成Base64编码直接写入HTML，避免依赖外部链接，兼容性更好：

1. 先把Logo图片转成Base64字符串（可以用在线工具，或者本地执行base64 logo.png命令生成）
2. 在Twig模板里直接引用：

   <img src="data:image/png;base64,这里替换成你的Base64字符串" alt="站点Logo">
   

⚠️ 提醒：这个方法适合小尺寸Logo，太大的图片会让邮件体积骤增，影响发送和加载速度。

方法3：利用Mime Mail的嵌入附件功能（推荐，动态场景友好） #

Mime Mail支持将图片作为内嵌附件（inline attachment），通过cid引用，能保证在大多数邮件客户端里正常显示：

步骤1：添加Logo为邮件附件 #

• 如果是Webform里的自定义文件字段，直接在邮件设置的「附件」部分勾选该字段；
• 如果是站点默认Logo，可以通过自定义模块的钩子来添加：

  function 你的模块名_webform_mail_alter(array &$message, array $context) {
    // 获取站点默认Logo的文件对象
    $logo_fid = \Drupal::config('system.site')->get('logo.fid');
    if ($logo_fid) {
      $logo_file = file_load($logo_fid);
      $message['params']['attachments'][] = [
        'filecontent' => file_get_contents($logo_file->getFileUri()),
        'filename' => $logo_file->getFilename(),
        'filemime' => $logo_file->getMimeType(),
        'cid' => $logo_file->getFilename(), // 这个cid要和Twig里的引用一致
      ];
    }
  }
  

步骤2：在Twig模板里用cid引用 #

<img src="cid:logo.png" alt="站点Logo">

⚠️ 注意：要确保在Mime Mail的设置页面（/admin/config/system/mime-mail）里启用了「允许嵌入附件」的相关选项。

方法4：检查Twig模板的变量渲染权限 #

有时候空标签是因为模板里的变量没有被正确传递：

• 打开Webform邮件模板的设置页面，查看「可用变量」列表，确认你使用的Logo相关变量是存在的；
• 如果需要自定义变量，可以在邮件设置的「高级」选项里添加，把Logo的URL/Base64字符串手动传递到模板中。

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