跳到内容

排除 HubSpot 表单故障

上次更新时间: 二月 13, 2025

除非另有说明,否则适用于以下任何订阅

所有产品和计划

HubSpot 表单可让您从网站上生成线索,并在 HubSpot 中收集有关访客和联系人的重要信息。如果您在表单行为或提交方面遇到困难,请查看不同的常见问题和解决步骤。

一般故障排除步骤

如果你的表单提交出现问题,可能是 HubSpot 表单本身或表单嵌入的页面造成的。要排除故障,你可以测试你的 HubSpot 表单:

  • 在另一个浏览器标签页中打开表单的独立页面 URL。该独立页面没有任何可以影响表单的元素。
  • 测试提交表格。
  • 检查提交的测试:
    • 如果提交成功,问题可能与嵌入的页面有关。与你的开发人员一起检查页面上可能影响提交的元素,如任何脚本或附加样式表。
    • 如果提交也受到相同错误的影响,请联系 HubSpot 支持

排除常见的表单行为问题

以下是您在设置表单时可能会遇到的一些常见问题,以及通常的解决步骤。更新表单后,再次发布并检查表单。

错误 解决错误的步骤

字段未出现在实时表格中

在另一个浏览器选项卡中检查表单的独立页面 URL,确保更新后的表单已发布。

如果将表单添加到页面时,表单上仍未显示某些字段,则很可能是表单具有渐进式字段,HubSpot 从以前的交互或测试中记住了访问者。如果访问者以前填写过该字段,或者联系人已经有了该属性的值,那么渐进字段就会被隐藏。

如果希望字段显示一致,请将该字段添加为常规表单字段,而不是渐进式表单字段。

属性不能作为表单编辑器中的字段使用

如果某个属性不能作为表单字段使用,可能是因为没有设置为在表单中显示。要启用在表单中显示的属性,请执行以下操作
  • 在 HubSpot 帐户中,单击顶部导航栏中的 settings“设置”图标
  • 在左侧边栏菜单中,导航至属性。
  • 单击属性名称。
  • 选择 "在表单和机器人中使用"复选框。如果属性有多个选项,则必须为每个要在表单中使用的选项打开 "在表单中显示"开关。
  • 在左下角单击 "保存"。



智能内容没有出现在我的感谢页面上

不能在感谢页面上使用智能内容。当访问者提交表单并被重定向到感谢页面时,没有足够的时间让表单得到处理,也没有足够的时间让 HubSpot 判断联系人是否符合感谢页面上的智能内容规则。

您提供了不安全的 richtext HTML 错误

当您在表单中包含了不 允许使用的 HTML 标记或属性时,就会出现 "您提供了不安全的 richtext HTML "错误。

要解决此错误并保存表单,请对照以下内容检查表单中富文本区域的源代码:

  • 任何 <script> 标记都是不允许的,应删除。
  • 不允许使用任何脚本 HTML 属性(如 "onmouseover"、"onclick"),应将其删除。
  • 图片中的所有 URL 必须以 "http://"或 "https://"开头。
  • 所有链接 URL 必须以 "http://"、"https://"、"mailto: "或 "tel: "开头。
  • 所有链接标记只能有 "href"、"target"、"name "和 "rel "HTML 属性。

排除常见的表单提交问题

以下是提交表单时可能遇到的一些常见问题,以及解决这些问题的典型步骤。更新表单后,可以尝试再次发布和检查表单。

错误 解决错误的步骤

表单提交数量多于联系人数量/表单提交后未创建联系人记录

当点击并处理表单上的 "提交"按钮时,将记录表单提交情况。这些是表单提交数可能高于创建联系人数的一些常见原因:
  • 使用同一电子邮件地址多次提交表单。因此,只创建了一个联系人,但每个表单提交仍被记录下来。为避免出现这种情况,请在表单的 "选项 "选项卡中打开 "总是为新电子邮件地址创建联系人 "设置。
  • 联系人可能已被删除。如果联系人从 HubSpot 中删除,其表单提交仍将计入总数,但该联系人将不再出现在根据表单提交过滤的列表中。
  • 提交表单时未填充电子邮件字段。要让表单提交在 HubSpot 中创建联系人记录,必须在表单中使用默认电子邮件字段。否则,您必须允许没有电子邮件地址的表单提交创建联系人
  • 表单提交使用了已与联系人记录关联的电子邮件地址,或者提交是在浏览器中完成的,该浏览器带有与现有联系人记录绑定的跟踪 cookie。在这种情况下,提交将更新现有的联系人记录,而不会创建新的记录。进一步了解 HubSpot如何 重复联系人以及如何重新创建被表单提交覆盖的联系人

提交表单时,联系人未记录页面浏览

为了正确跟踪页面浏览量,请检查网站上是否安装了 HubSpot跟踪代码正确启动

如果跟踪代码已安装并正确启动,但联系人的页面浏览数属性值仍为 "0",很可能是因为联系人提交表单时阻止了 cookie。这可能有几个原因:

表单提交未显示在关联对象的活动时间轴上

在关联对象的活动时间轴中显示表单提交:
  • 表单必须包含属于该对象类型的表单字段。
  • 提交表单时,必须填入属于该对象类型的表单字段。

例如,如果表单包含一个公司属性表单字段,且该字段在表单提交时已填入,则表单提交将出现在联系人关联公司的活动时间线中。为确保始终填入该字段,可以将表单字段设置为必填字段

无联系记录错误

如果您不允许不带电子邮件地址的表单提交创建联系人,那么有两个原因会导致表单提交中不显示联系人记录:
  • 表单中未包含和/或必填电子邮件字段。
  • 与提交相关的联系人已从 HubSpot 中删除

无记录错误

该错误表示 HubSpot 无法确定提交发生的位置。这可能有两个原因:

提交表格后未记录页面访问

当表单提交没有记录页面访问时,很可能是因为访客的 IP 地址被排除在网站分析之外
  • 如果访客在被排除的 IP 地址上提交表单,他们的提交会被记录在表单提交分析中,但页面访问不会被计算在内。
  • 如果您是 HubSpot 账户的用户,并且不在被排除的 IP 地址上,您的表单提交和页面访问都将被计算在内。
该错误可能由以下原因造成:
  • 提交源于通过 HubSpot 的 API 进行的外部集成,不包含 cookie。
  • 访问者的浏览器阻止了 cookie。
  • 访问者不接受 cookie 横幅。
  • 访问者使用过滤的IP地址提交。

从联系人提交的表单中删除文件

HubSpot 表单工具配备了病毒检测功能,可防止在提交表单时上传可疑文件。

如果访客在提交表单时上传了文件并被检测到有病毒,提交详情中就会出现[文件名]已从提交中删除的 信息。

在我的表格通知中显示其他公司信息

如果 HubSpot 在我们的数据库中有其他公司信息,HubSpot 会将这些信息自动填充到通知的底部。

联系人缺少IP 国家、IP 州或IP 城市的值

HubSpot使用多个第三方数据库尝试将访问者的IP地址与其地理位置相匹配。联系人的IP 国家、IP 州/地区或IP 城市可能为空,这有两个原因:
  • 联系人必须提交启用了cookie跟踪功能的表单,或与关联IP地址的HubSpot跟踪电子邮件进行交互(打开或点击)。
  • HubSpot无法在其数据库中找到匹配的地理位置属性。在某些地理位置,IP 地址定位数据可能不准确或不稳定,因此 HubSpot 可能无法找到所有三个 IP 属性的数据。

排除常见的表单显示问题

以下是妨碍表单在 HubSpot 或外部页面显示的一些常见问题,以及典型的解决步骤。

错误 解决错误的步骤

表单未显示在 HubSpot 页面或外部页面上

如果您的表单没有显示在 HubSpot 或外部页面上,可能是页面上的代码发生冲突,导致表单无法显示。最常见的是来自 One Trust 的OtAutoBlock.js 脚本。

默认情况下,在访问者接受 cookie 之前,表单不会出现在运行该脚本的任何页面上。

要向所有访客(包括未接受 cookie 的访客)显示表单,需要从外部管理脚本。您可以考虑以下选项:

  • 配置 OneTrustOtAutoBlock.js 脚本中的 allowlist 脚本,允许表单渲染。建议与您的开发人员合作完成此项工作。
  • 向 OneTrust 咨询是否可以允许 HubSpot 的表单嵌入脚本。
  • 完全删除 OneTrust 的OtAutoBlock.js 脚本。

请注意:在评估您的故障排除步骤、使用同意横幅和考虑您的隐私政策时,您的法律团队是根据您的具体业务情况为您提供合规建议的最佳资源。

外部页面上不显示表单

如果外部页面上不显示表单,可能是表单嵌入代码或网站主机出了问题。了解如何排除外部嵌入表单的故障

嵌入式表单在外部页面的错误位置显示

在外部页面上嵌入 HubSpot 表单后,如果表单显示的位置与希望的位置不同,可能是由于以下原因造成的:
  • 表单在页面上动态呈现。
  • 多个表单嵌入代码被添加到同一个<div>标签。
  • 由于使用的是旧版浏览器,表单无法加载。

进一步了解如何通过更新表单嵌入代码来解决这些问题

我们在加载此表格时遇到了一些问题。单击此处继续错误

HubSpot 表单使用 JavaScript 构建,可添加字段验证、依赖字段和动态错误信息等功能。不过,这意味着如果启用了Ghostery和Privacy Badger等资源屏蔽浏览器扩展,它们可能会阻止你的表单加载和显示。

单击此处继续文本超链接到https://www.hubspot.com/products/marketing/forms?utm_source=share.hsforms.com&utm_medium=referral&utm_campaign=hsforms-redirect,这是一个由 HubSpot 控制的受保护域。当访问者点击该链接时,他们将被带到一个独立的表单页面,在那里他们可以提交表单。

该链接包括查询字符串中原始表单嵌入代码的完整上下文,以及原始页面信息(如标题和 URL)。独立页面上的表单与原始表单的行为完全相同。独立页面上的表单提交将传递与原始表单提交相同的分析信息。

这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助