跳到内容
请注意：：本文仅为方便您阅读而提供。本文由翻译软件自动翻译，可能未经校对。本文的英文版应被视为官方版本，您可在此找到最新信息。您可以在此处访问。

排除 HubSpot 表单故障

上次更新时间： 2026年4月24日

可与以下任何订阅一起使用，除非另有说明：

HubSpot 表单可帮助您从网站获取潜在客户，并在 HubSpot 中收集有关访客和联系人的重要信息。如果您在表单行为或提交方面遇到困难，请查看各种常见问题及其解决步骤。 

一般故障排除步骤 

如果您遇到表单提交问题，可能是由 HubSpot 表单本身或嵌入表单的页面引起的。要排查此问题，您可以测试您的 HubSpot 表单：

  1. 在另一个浏览器标签页中打开表单的独立页面 URL。该独立页面不包含任何可能影响表单的元素。
  2. 向表单进行测试提交。
  3. 检查测试提交结果：
    • 如果提交成功，问题很可能与表单嵌入的页面有关。请咨询您的开发人员，了解页面上可能影响提交的元素，例如脚本或附加的样式表。
    • 如果提交也受到相同错误的影响，请联系 HubSpot 支持团队。

排查常见表单行为问题

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

错误 解决此错误的步骤 

某个字段未在已发布表单中显示

 请在另一个浏览器标签页中检查表单的独立页面 URL，确保您已发布的表单已更新。

若将表单添加至页面后仍有部分字段未显示，可能是因为表单包含渐进式字段，且 HubSpot 根据访客的先前交互或测试记录进行了识别。当访客曾填写过该字段，或联系人已拥有该属性的值时，渐进式字段将被隐藏。

若希望字段始终显示，请将其添加为常规表单字段，而非渐进式表单字段。 

添加到 HubSpot 页面的表单显示的感谢信息与表单编辑器（旧版）不一致

 当表单（旧版）添加到 HubSpot 页面时，页面编辑器中设置的感谢信息将覆盖表单编辑器中的设置。当表单设置为内联感谢信息，或重定向至 HubSpot 页面或外部页面时，将发生这种情况。 

因此，当将旧版编辑器中创建的表单添加到 HubSpot 页面时，您必须在页面编辑器的表单模块中设置内联感谢信息或重定向至其他页面。

此规则不适用于条件表单重定向或重定向至日程安排页面。这些设置在表单编辑器中配置时具有优先级。

该属性在表单编辑器中无法作为字段使用

 

 如果某个属性无法作为表单字段使用，可能是因为该属性未配置为在表单中显示。要启用该属性以便在表单中显示： 
  1. 在 HubSpot 帐户中，单击顶部导航栏中的 settings “设置”图标。
  2. 在左侧边栏菜单中，导航至“属性”。
  3. 点击该属性的名称。
  4. 在左侧边栏菜单中，导航至“规则”。 
  5. 选中“在表单中显示该属性”复选框。如果您的属性有多个选项，则必须为每个要在表单中使用的选项开启“在表单中显示”开关。
  6. 在右上角，点击“保存”。

 

我的感谢页面上未显示智能内容

 您无法在感谢页面上使用智能内容。

当访客提交表单并被重定向至感谢页面时，表单处理的时间不足，HubSpot 也无法及时判断该联系人是否符合感谢页面上的智能内容规则。

您提供的富文本 HTML存在安全风险

 当表单中包含不允许的 HTML 标签或属性时，会出现“您提供的富文本 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 地址，您的表单提交和页面访问将被计入统计。

未找到此提交对应的 Cookie错误

 此错误可能由以下原因引起：
  • 该表单提交源自通过 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 或外部页面上显示，可能是页面上存在冲突的代码导致此问题。最常见的情况是 OneTrust 的OtAutoBlock.js脚本。

默认情况下，在运行此脚本的任何页面上，表单都不会显示，直到访客接受 Cookie 为止。

若要向所有访客（包括尚未接受 Cookie 的访客）显示表单，需在外部管理该脚本。您可以考虑以下方案：

  • 请在 OneTrust 的OtAutoBlock.js脚本中配置白名单脚本，以允许表单渲染。建议您就此与开发人员合作。
  • 请咨询 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 帮助。

相关内容

目录 /zh-cn/forms/troubleshoot-hubspot-forms?hsSkipCache=true 菜单

相关内容

New call-to-action