电子邮件模板错误消息疑难解答

预计阅读 3 分钟 | 更新于 2026年4月21日 9:54 AM EST

你将会学到

如果您在电子邮件模板中遇到错误或警告,您可能需要在发送消息之前解决它们。在此资源中搜索您遇到的错误消息或警告,以查找解决问题的提示。

活动发送警告

  • 我们在您的电子邮件中发现 # 个块,其中默认文本仍然未修改或为空白。请在继续之前查看您的电子邮件。
  • 如果您遇到此警告,请在模板中查找空块或占位符内容(例如,“这是一个文本块。单击此处对其进行编辑。”)。检查模板的桌面版和移动版。如果您找不到空块或占位符内容,请向自己发送预览消息并在桌面和移动设备上查看。如果预览看起来不错,则可以安全地发送消息并忽略此警告。 – 可能的电子邮件内容问题。您的电子邮件中似乎没有任何链接。您是否忘记将它们添加到您的电子邮件中? 如果您的纯文本或自定义 HTML 电子邮件不包含任何链接,则会出现此警告。查看消息以确保已添加所有内容,包括任何号召性用语的链接。如果您不想在电子邮件中包含任何链接(取消订阅链接除外),则可以忽略此警告。 – 取消订阅链接。我们在您的电子邮件中找不到取消订阅链接。如果您不添加,Klaviyo 会在发送电子邮件时自动添加取消订阅链接。 如果您尚未在邮件中添加取消订阅标签(例如,{% unsubscribe %} 或 {% unsubscribe\_link %}),则会出现此警告。 添加取消订阅链接以避免将 Klaviyo 的默认页脚附加到您的消息中。

预览错误

预览消息时,您可能会遇到以下错误消息:

显示的消息不带标签或变量 修复无效的模板标签或变量以预览具有实际配置文件和事件的消息。

此错误意味着您的消息中某处存在无效语法。要找到错误的根源,请检查邮件的主题行和正文内容中是否存在不符合 Klaviyo 帮助中心资源 中概述的格式的变量、标签或条件语句(即模板中用大括号 {} 括起来的任何内容)。以下是一些定位错误的提示:

  • 检查您的消息的桌面版和移动版。 – 如果您的消息包含动态优惠券,请确保优惠券名称正确,并且您的优惠券已在 优惠券 选项卡中配置。

自定义 HTML 模板错误

  • 我们找不到以下图像:…确保它们包含在您上传的 zip 文件中。
  • 检查您是否正确拼写了所有图像源路径,并且它们是否与您上传的图像的文件名匹配。如果错误消息中未提供图像路径,请检查 HTML 文件中是否有空背景属性(例如 background=””

  • 需要一个 {% unsubscribe %} 标签。
  • Klaviyo 取消订阅标签 添加到消息页脚以解决此错误。 – 无法解析余数:“XYZ”中的“Z”。 此错误意味着 Klaviyo 无法识别您的标签之一(任何被 {% %} 包围的标签)。请参阅我们的消息个性化参考指南以查看接受的标签。

目录错误

如果您的模板使用目录查找标签,您可能会遇到错误无法找到代码为:\_\_的项目。它可能已被删除。

如果您看到此错误,则意味着我们无法识别选项卡中包含的项目 ID。确保:

  • 您正在预览包含项目 ID 的事件(如果项目 ID 动态引用事件数据)。 – 对事件数据的项目 ID 的引用格式正确。 – 您的活动数据中的商品 ID 与您的 Klaviyo 目录中的商品 ID 相匹配。

Shopify 模板错误

  • { % for item in… – {% endfor %}
  • {% 如果… – {% elsif… – {%其他%}
  • {% endif %}
  • Body html Liquid 语法错误:未知标签“取消订阅”
  • 正文 html Liquid 语法错误:未知标签“web\_view” 这些错误以及类似的其他错误意味着在将模板导出到 Shopify 之前,已将 Klaviyo 特定的标签添加到您的模板中。 Shopify 不支持 Klaviyo 的取消订阅、管理首选项或 Web 查看链接。 – Body Html Liquid 语法错误:未知标签“Load” Shopify 不支持 Klaviyo 的产品块功能。如果您将产品块添加到 Shopify 通知模板中,然后将该模板导入到 Shopify 中,则会出现此错误。删除产品块,导出模板的 HTML,然后将其导入 Shopify。 – Body html Liquid 语法错误:未知标签“elsif” 正文 html Liquid 语法错误:“if”标签从未关闭 正文 html Liquid 语法错误:“X”标签从未关闭 Klaviyo 的许多 Shopify 通知模板都包含条件语句,这使您的消息根据客户的订单状态而动态变化。如果条件语句的一部分被删除,您将看到类似上面的错误。要解决此问题,请在 Klaviyo 中打开模板并删除条件语句的剩余元素。搜索以下开头的标签: