跳到内容

审查导入错误并排除故障

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

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

所有产品和计划

将记录或活动导入HubSpot 时,您可能会遇到错误。下面,我们将介绍如何解决导入过程中检测到的错误、下载错误文件、查看错误详细信息以及纠正导入文件或 Salesforce 中的问题。

在开始导入或修复有错误的文件之前,请了解导入到 HubSpot 的相关术语和要求

修复导入过程中的错误

在完成导入之前,HubSpot 会检查文件前 1000 行中的某些错误。如果检测到以下错误,会在导入过程中映射属性时提请你注意:

要解决这些错误,请从 "将文件中的列映射到 HubSpot 属性"屏幕:

  • 单击[x] 错误。

  • 在右侧面板中,查看有关错误类型的详细信息,包括受影响的列和行。
  • 要查看映射到的属性,请单击右上角的属性名称。
  • 要了解特定错误的更多信息,请单击错误名称。
  • 要查看文件中受影响的行,请单击查看有错误的值。
  • 如果有建议的解决方案,则会出现 "修复错误 "部分。查看建议的解决方案,然后根据错误,执行以下操作:
    • 要编辑属性,请单击 编辑 [名称] 属性。属性编辑器将出现在右侧面板中。根据建议更新属性(例如,编辑属性名称或选项),然后单击保存。
    • 枚举属性关联标签的值重新映射到现有选项:
      • 要手动重新映射,请单击受影响行中的 "选择选项",然后选择选项更新值,或选择 "忽略错误"忽略值。如果忽略该值,则导入的行中将没有该属性的值。
      • 要自动重新映射,请单击自动修复错误。如果没有明确的替换,自动修复可能不会成功。
      • 要重置单个更改,请单击更新选项,然后单击重置更改。要撤销所有更改,请单击重置所有更改。
    • 要更新值的格式(如不正确的日期格式),请单击下拉菜单 并更新值的格式。
    • 如果属性是只读的(如某些默认的 HubSpot 属性),请单击查看[名称]属性以查看该属性的详细信息。你不能编辑只读属性,因此需要更新并重新导入文件才能解决错误。
  • 在 "其他选项"部分,单击right 展开并查看每个附加选项。
  • 解决错误后,"已映射"一栏中将出现success 复选标记。

请注意:如果您的文件包含超过 1000 行,可能还有其他错误没有解决。

查看导入

完成导入后,您将自动看到导入摘要,包括任何错误的概述。您还可以查看以前完成的导入的摘要。

  • 如果导入有错误,则会出现 导入错误部分。在表格中,查看以下信息:
    • 从文件导入列:文件中受错误影响的列标题。
    • 对象类型:分配给受影响列的CRM 对象 或活动。
    • HubSpot 属性:与受影响列匹配的 HubSpot 中的属性
    • 错误类型:受影响列的错误类型。了解有关所有 导入错误的更多信息
    • 错误影响:因错误而未导入的行数或属性值。如果一行未导入,则表示受影响行中的所有无法导入。如果未导入某个值,则表示无法导入该特定属性列中的值,但可以导入该行中的其他列。

  • 要查看特定错误的更多信息,请将鼠标悬停在该行上,然后单击 "查看详细信息"。
  • 要查看包含错误的所有行,请单击查看有错误的行。在 "有错误的行"页面上
    • 在表格中,查看该行及其包含的错误。受错误影响的列将包含一个exclamation 警报图标。单击最左侧列中的错误名称,查看错误原因和解决方法。
    • 单击下载有错误的行作为文件,以下载受影响的行及其错误。单击下载的压缩文件提取 CSV 文件,然后打开该文件。
  • 要以文件形式下载错误列表,请在表格上方单击下载错误作为文件。
    • 单击下载的压缩文件提取 CSV 文件,然后打开文件。
    • 在文件中,确定错误代码列中的错误代码、对象类型 列中受影响记录的对象、原因 列中的错误原因以及其他列中记录的属性值。

请注意:在导入后屏幕和下载的错误文件中,导入错误中的敏感数据将被替换为REDACTED 字样。要查看值,请参阅原始导入文件。

确定导入错误后,请学习如何解决特定错误。

导入文件错误

以下是按字母顺序排列的错误代码列表,包含错误的详细信息和可能的解决步骤。在某些情况下,有错误的记录或活动会被导入,可以在 HubSpot 中更正,或更正导入文件并重新导入。在其他情况下,记录或活动不会导入,导入文件需要更正后才能重新导入。

请注意: 下载文件中的错误代码包含大写字母和下划线字符,但在本文中以正常文本列出。例如,错误在文件中显示为 AMBIGUOUS_ENUMERATION_OPTION,但在下面的列表中显示为 Ambiguous enumeration option。

模棱两可的枚举选项

错误含义

同一条记录与一个枚举属性定义的多个现有选项相匹配这适用于多选、下拉选择、单选和复选框类型属性。

如果文件中的值是属性选项的标签而不是其内部值,也可能出现此错误。这适用于标签与内部值不同的枚举属性选项

已导入受影响的记录,但枚举属性不包含值。

如何解决错误

将导入文件与HubSpot 中的属性进行比较,找出不正确的值。更新导入文件中的值,使其只匹配一个现有选项,如果标签与选项的内部值不同,则匹配选项的内部值。更新值后,重新导入文件。

您也可以手动更新 受影响记录中的属性值 。如果您的记录应匹配多个选项,请学习如何格式化文件以正确导入多个复选框属性的数据。

未找到关联标签

错误含义

在导入过程中,一列包含关联标签,但该标签不存在于 HubSpot 中。数据已导入,但生成的关联没有标签。

如何解决该错误

将导入文件与HubSpot 中的关联标签进行比较,找出不正确的值。确保您的值与现有标签匹配,或创建一个新标签。如果导入的是配对标签,请确保相应对象使用了正确的标签(例如,雇主应用于公司,雇员应用于联系人)。完成后,重新导入文件或手动更新 受影响记录中的标签

超出关联限制

错误含义

您之前为记录之间允许的总关联或标签关联数量设置了关联限制,但您的导入包含了超出限制的关联。数据已导入,但导入后的记录未在 HubSpot 中关联。

如何解决错误

如果记录应该关联或有特定标签来定义关联,请更新关联限制,然后重新导入文件或在 HubSpot 中手动更新关联

未找到关联记录

错误含义

在导入过程中,一列被映射到 唯一标识符属性以关联记录(即记录 ID、电子邮件、公司域名或自定义唯一值属性)。但是,文件中没有包含所需的唯一值。如果使用的唯一标识符值包含换行符或超过 100 个字符,也会出现这种情况。数据已导入,但生成的记录在 HubSpot 中没有关联。

如何解决错误

更新导入文件以包含正确的值,然后重新导入文件。您可能需要导出现有记录以获得正确的记录 ID,为现有记录使用不同的唯一标识符。了解如何正确设置文件以导入和关联多个对象。

找不到所有者

错误含义

导入文件包含的记录所有者与 HubSpot 中的用户不匹配。已导入受影响的记录,但所有者字段不含值。

如何解决该错误

确认要将记录分配给的人是账户中的活跃用户,然后更新导入文件所有者列中的数据,使其包含用户的姓和名或电子邮件。

  • 如果要分配记录的人还不是账户的用户,请将其添加为用户,然后使用账户中显示的姓名或电子邮件重新导入。
  • 如果要指定的人是已停用的用户,请重新激活该用户,然后使用账户中显示的姓名或电子邮件重新导入。

无法解析日期

错误含义

导入文件包含的日期值与您在 导入过程中选择的格式不匹配已导入受影响的记录,但日期属性不包含值。

如何解决该错误

用正确的值更新导入文件并重新导入,或手动更新受影响记录中的属性值

无法解析数字

错误含义

导入文件中的数字属性值包含非数字字符。已导入受影响的记录,但数字 属性不包含值。

如何解决该错误

用正确的数值更新导入文件并重新导入,或手动更新 受影响记录中的属性值

无法解析记录

错误含义

导入文件包含无法处理的数据行。如果是必填属性,则记录导入。如果不是必填属性,则记录已导入,但该属性不包含值。

如何解决错误

验证数据值是否与导入属性的正确格式一致,修正任何错误,然后重新导入文件。您也可以手动更新 受影响记录中的属性值

无法解析术语

错误含义

导入文件中包含的时间段值与可接受的术语格式不匹配。受影响的记录仍被导入,但术语属性不包含值。

如何解决该错误

将文件中的期限值更新为整月数或ISO8601 期限格式(例如,3 年 6 个月 4 天的期限为 P3Y6M4D),然后重新导入文件。您也可以手动更新 受影响记录中的属性值

仅创建导入

错误的含义

选择了导入只能创建新记录,但您的导入文件包含与 HubSpot 中现有记录匹配的唯一标识符值。例如,您导入的电子邮件值已经与现有联系人的电子邮件(包括其他电子邮件)相匹配,或者您导入的公司域名值已经与现有公司的域名(包括其他域名)相匹配。受影响的行未被导入,因此现有记录未被更新,但包含新信息的行确实创建了新记录。

如何解决错误

如果您的目标是只创建新记录,避免更新现有记录,那么您不需要采取任何措施。如果您确实想更新文件中的现有记录,请重新导入文件,然后在导入过程中选择创建新记录和更新现有记录

重复的备用 ID

错误含义

您的文件中多次使用了相同的备用 ID。您的数据已导入,但 HubSpot 中的同一记录可能存在重复。如果您试图关联,您的记录没有关联。

如何解决错误

选择不同的列标题作为备用 ID,然后重新导入文件。
  • 避免重复,联系人使用电子邮件,公司使用公司域名,任何对象使用记录 ID 。
  • 关联记录,可使用电子邮件、公司域名、记录 ID,或选择一对多属性,其中一个值对与之关联的许多记录而言是唯一的(例如,以公司名称为唯一值,该值将与在同一公司工作的许多联系人关联)。有关进一步指导,请参阅示例导入文件
如果有多个公司使用相同的域,可以考虑 手动创建父子公司

重复关联 ID

错误含义

您选择用于关联记录的关联 ID 不唯一。

如何解决该错误

选择不同的列标题作为两个文件之间的公共列。为获得最佳效果,请选择一对多属性,其中的一个值对于与之关联的许多记录来说都是唯一的(例如,以公司名称为属性,该属性将与在同一家公司工作的许多联系人关联)。有关进一步指导,请参阅示例导入文件 。选择新的关联 ID 后,重新导入文件。

重复记录 ID

错误含义

同一记录 ID 在您的文件中被多次使用。受影响的记录未在 HubSpot 中更新或关联。

如何解决该错误

更新导入文件,使该记录 ID只有一行保留您希望包含在 HubSpot 中的最新信息行。删除重复内容后,重新导入文件。

重复的行内容

错误含义

HubSpot 检测到导入文件包含重复记录。导入没有创建新记录。

如何解决该错误

删除导入文件中的重复记录并重新导入。

重复的唯一属性值

错误含义

HubSpot 中的唯一标识符属性在所有记录中强制执行该属性值的唯一性。与文件中的其他行或 CRM 中的其他记录相比,映射到唯一标识符属性的列中的某些值并不唯一。如果该属性在文件中不唯一,则只导入了该属性引用的一条记录。如果该属性值与 CRM 中的另一条记录冲突,则未导入该记录。

如何解决错误

选择不同的列标题作为唯一值,或删除重复值,然后重新导入文件。

如果文件包含多个唯一标识符属性:

  • 可能存在冲突的唯一值(例如,电子邮件和自定义唯一属性,其中自定义属性具有唯一值,但存在重复的电子邮件)。删除冲突的唯一值,然后重新导入。
  • 如果要更新其中一个唯一值属性,请在导入时选择不想更新的属性作为查找现有 [对象] 的属性。

请注意:如果使用记录 ID 作为唯一标识符,它将取代导入中的任何其他唯一标识符。联系人属性 "电子邮件 "也始终需要唯一值。


创建关联失败

错误含义

HubSpot 无法以当前格式关联您的记录。记录已导入,但未关联。

如何解决该错误

确认你已满足关联记录的文件要求。如果以一个文件导入,可能需要为每个对象添加唯一标识符。如果以两个文件导入,可能需要选择不同的 公共列才能正确关联。更改文件并重新导入,或手动关联记录

退出联系人失败

错误含义

HubSpot 无法选择退出文件中的某些联系人。

如何解决该错误

确认 选择退出列表中的所有联系人都有电子邮件 值。如果缺少电子邮件,请将其电子邮件地址添加到文件中,以正确退出联系人接收电子邮件。您也可以 手动创建联系人,并 从联系人记录中将其退出。

处理属性值为空的对象失败

错误含义

您的文件包含多列空值,HubSpot 无法处理该记录。该行中的数据被导入。

如何解决该错误

填写导入文件中缺失的属性值,然后重新导入文件。

电子邮件、交易/票据 阶段或交易/票据管道验证失败

错误含义

导入文件包含的电子邮件地址不符合典型电子邮件地址的格式(如 name@domain.com),或者交易阶段、交易管道、票据状态或票据管道 属性值与 HubSpot 中现有的阶段、状态或管道名称不匹配。导入 没有创建或更新记录。

如何解决错误

对于联系人,用正确的电子邮件更新导入文件,然后重新导入文件。对于交易或票据,用正确的阶段、状态和管道名称更新导入文件,或在 HubSpot 中添加自定义 交易阶段票据状态。完成后,重新导入文件。

未找到文件

错误含义

未找到您选择的文件。导入您的数据。

如何解决该错误

确认您已将文件保存到电脑中,且文件类型正确。确认无误后,重新上传文件。

GDPR 屏蔽列表中的电子邮件

错误含义

导入文件中包含一个或多个因数据隐私而被阻止通信的电子邮件。这些联系人被导入。

如何解决该错误

导入文件仍将导入其他联系人,但无法通过导入添加被阻止的联系人。将永久删除的联系人添加回 CRM 的唯一方法是要求他们提交表单。一旦联系人提交了表单,他们就会在 CRM 中创建为新的联系人。

列数不正确

错误含义

导入文件中至少有一列没有标题。导入无标题列中的数据。

如何解决该错误

确认是否应导入列中的数据,添加适当的标题或删除列,然后重新导入文件。

附加电子邮件无效

错误的含义

在导入带有附加电子邮件的联系人时,文件中包含的电子邮件地址要么是无效的电子邮件格式,要么是已被用作其他联系人的电子邮件。受影响的记录仍被导入,但未添加附加电子邮件。

如何解决该错误

如果电子邮件格式不正确,请使用正确的电子邮件格式更新文件,然后重新导入。如果电子邮件已在另一个联系人上使用,但应在新联系人上使用,请从现有联系人记录中删除电子邮件,然后重新导入文件。如果电子邮件已用于另一个联系人,而该现有联系人应保留电子邮件,则无需采取任何措施。

备用 ID 无效

错误含义

导入文件包含作为电子邮件地址、域名或记录 ID 导入的无效值。 导入创建或更新记录。

如何解决该错误

用正确的电子邮件、域名或记录 ID值更新导入文件,然后重新导入文件。

关联标识符无效

错误含义

导入文件中没有适当的唯一值来关联记录。如果使用了非唯一属性,或者唯一标识符的值包含换行符或超过 100 个字符,就会出现这种情况。数据已导入,但导入的记录未在 HubSpot 中关联。

如何解决错误

更新导入文件以包含有效的关联标识符(如联系人的电子邮件、公司的公司域名或记录 ID),然后重新导入文件。了解如何正确设置文件以导入和关联多个对象。

枚举选项无效

错误含义

导入文件包含的值与枚举属性中的现有选项不匹配。这适用于多选、下拉选择、单选和复选框类型属性。受影响的记录仍被导入,但枚举属性不包含值。

如何解决该错误

将导入文件与HubSpot 中的属性进行比较,找出不正确的值。对于 HubSpot 默认的枚举属性(如生命周期 阶段、行业),请确保您的值与选项的英文标签或其内部值相匹配。你可以选择更新导入文件中的值以匹配现有选项,或将该值作为自定义选项添加到属性中。完成后,重新导入文件或手动更新 受影响记录中的属性值

无效事件

错误含义

对于自定义事件营销事件导入,导入文件包含无效事件(例如,开始时间在结束时间之后的事件)。导入受影响的行。

如何解决该错误

更新文件以包含有效的事件属性值,然后重新导入。

事件时间戳无效

错误含义

对于自定义事件导入,导入文件中的Occurred at属性包含空或无效的时间戳。已导入受影响的行,但该属性不包含值。

如何解决该错误

在可接受的时间戳范围(2000-01-01 至 3000-01-01)内添加或更新值,然后重新导入。

文件类型无效

错误含义

导入 HubSpot 的文件类型不正确。您的数据没有导入。

如何解决该错误

将文件转换为 .csv、.xls 或 .xlsx 文件,然后重新导入。查看导入 HubSpot 的其他文件要求

数字大小无效

错误含义

导入文件中的数值过小或过大。已导入受影响的行,但数字属性不包含值。

如何解决该错误

确认特定属性或属性类型的格式要求,更新文件以匹配正确的格式,然后重新导入。您也可以手动更新 受影响记录中的属性值

无效记录 ID

错误含义

在导入过程中,文件的一列被映射到记录 ID。但是,文件中列出的 记录ID 与 HubSpot 中的现有 ID 不匹配。记录没有导入。

如何解决错误

确保记录 ID 正确。您可能需要导出现有记录以获得正确的记录 ID,或为现有记录使用不同的唯一标识符。如果不更新或关联 HubSpot 中的现有对象,请不要导入过程中选择复选框。

无效的必填属性

错误含义

导入文件中的必填属性包含无效值。导入该行中的数据。

如何解决该错误

确认特定属性或属性类型的格式要求,更新文件以符合正确格式,然后重新导入。

无效张数

错误含义

导入文件包含多个工作表。您的数据导入。

如何解决该错误

从导入文件中删除任何其他工作表,然后重新导入。查看导入 HubSpot 的其他文件要求

电子表格无效

错误含义

导入文件不是有效的电子表格文件。您的数据导入。

如何解决该错误

将文件转换为 .csv、.xls 或 .xlsx 文件,然后重新导入。查看导入 HubSpot 的其他文件要求

超出限制

错误含义

HubSpot 无法创建记录,因为您已经达到了该对象可存储 记录数的上限 。此错误适用于标准 CRM 对象:联系人、公司、交易和票据。您的数据没有导入。

如何解决该错误

删除该对象不再需要的任何记录,然后重新导入文件以创建新记录。了解有关HubSpot 订阅及其限制的 更多信息

行中有许多错误

错误的含义

导入文件中有一行包含 10 个以上错误。错误描述将列出该行的所有错误和受影响的列。根据错误的不同,该行可能没有被导入,或者导入时没有为受影响的列赋值。

如何解决错误

查看每个错误,然后更新并重新导入文件,或在 HubSpot 中手动更新受影响的记录/活动。

多个公司使用此域

错误的含义

导入文件中包含的公司域名值与您 HubSpot 账户中的多个公司相匹配。导入没有更新公司记录。

如何解决该错误

公司主页中搜索特定的公司域名值,找出重复的域名。合并公司记录或删除其中一条记录,然后重新导入文件。

发现多个所有者

错误含义

导入文件中包含的所有者值与账户中的多个用户匹配。这种情况通常发生在名称上(例如,您的 HubSpot 账户中有两个 John Doe 用户,而导入文件中包含的名称是 "John Doe")。受影响的记录已导入,但Owner 属性不包含值。

如何解决错误

在导入文件中用电子邮件地址替换所有者的姓名,然后重新导入文件。您也可以手动更新 受影响记录中的所有者 属性值

超出有效期范围

错误含义

导入文件中包含的时间段值超出了可接受的术语范围。已导入受影响的记录,但术语属性不包含值。

如何解决该错误

更新文件中的期限值,使其在可接受的时间范围内(大于或等于 1 个月的整数),然后重新导入文件。您也可以手动更新 受影响记录中的属性值

超出有效时间范围

错误含义

导入文件包含的时间段值超出了可接受的时间范围。已导入受影响的记录,但时间范围属性不包含值。

如何解决该错误

更新文件中的时间范围值,使其在可接受的时间范围内(少于 1000 年),然后重新导入文件。您也可以手动更新 受影响记录中的属性值

超出门户全局自定义对象限制

错误含义

HubSpot 无法创建记录,因为您已达到该自定义对象可存储 记录数的限制 。您的数据没有导入。

如何解决该错误

如果有您不再需要的记录,请删除该自定义对象中的记录,然后重新导入文件。如果您需要额外的记录存储空间,可以购买自定义对象记录限制增加。了解有关HubSpot 订阅及其限制的 更多信息

未找到属性定义

错误含义

导入文件包含的列标题与 HubSpot 属性不匹配。该列中的数据被导入。

如何解决该错误

在导入过程中,通过 选择现有属性或在 "将文件中的列映射到 [对象] 属性 "页面上 创建新属性来正确匹配列。 您也可以选择跳过导入未匹配的列。

属性验证规则错误

错误含义

导入文件包含的值不符合属性验证规则的要求(例如,值包含特殊字符、过长或过短等)。已导入受影响的记录,但属性不包含值。

如何解决错误

在设置中查看或编辑属性的验证规则。更新导入文件以包含符合属性规则的值,然后重新导入文件。您也可以手动更新 受影响记录中的属性值

未找到属性值

错误含义

导入文件中缺少一个必填属性值。导入该行中的数据。

如何解决该错误

更新导入文件以包含必填属性的值,然后重新导入文件。

行数据过大

错误含义

您的文件包含一个数据量超过 1 MB 的单元格或行,该数据量太大,导入工具无法处理。该行中的数据被导入。

如何解决该错误

缩小文件中受影响单元格或行的大小,然后重新导入文件。

未知不良请求

错误含义

导入文件包含一个无效的记录 ID ,与您 HubSpot 账户中的任何现有记录不匹配。导入更新记录,因为数据与任何现有记录不匹配。

如何解决该错误

验证记录 ID 是否正确。如果发现 ID 不正确,请使用正确的记录 ID 更新导入文件,然后重新导入文件。

未知错误

错误含义

由于未知错误,HubSpot 无法处理文件。您的数据导入。

如何解决该错误

确认您的文件符合所有要求清除浏览器缓存或使用其他浏览器后尝试重新导入。如果仍然出现错误,请在社区(所有用户)上发帖或联系支持团队(仅限入门、专业和企业账户)。

仅更新导入

错误的含义

选择了导入应仅更新现有记录,但您的导入文件包含的唯一标识符值与 HubSpot 中的现有记录不一致。例如,您导入的电子邮件值与现有联系人的电子邮件不匹配,或者记录 ID 值与现有记录不匹配。受影响的行没有被导入,因此没有创建新记录,但更新了现有记录。

如何解决错误

如果受影响的值本应与现有记录匹配,请确认值的拼写是否正确或是否包含正确的记录 ID编号。修正文件中的任何错误,然后重新导入。

如果您的目标只是更新现有记录,而不是创建新记录,则无需采取任何措施。如果您希望受影响的行创建新记录,请重新导入文件,并在导入过程中选择创建新记录和更新现有记录

Salesforce 导入错误

  • 导航到您的记录:
    • 联系人: 在 HubSpot 帐户中,导航到 CRM > 联系人
    • 公司: 在 HubSpot 帐户中,导航到 CRM > 公司
    • 交易:在 HubSpot 帐户中,导航到 CRM > 交易
    • 门票 在 HubSpot 帐户中,导航到 CRM > 票证
    • 自定义对象:在 HubSpot 账户中,导航至联系人 > 联系人,然后单击左上角的下拉菜单并选择自定义对象的名称。
    • 产品: 在 HubSpot 帐户中,单击顶部导航栏中的 settings“设置”图标。 在左侧边栏菜单中,导航至对象 >产品。
  • 在右上角,单击导入。如果在产品索引页面,请单击 "操作"下拉菜单,然后选择 "导入"。
  • 将鼠标悬停在有错误的 Salesforce 导入上,然后单击查看导入错误。
  • 在 "导入错误"表中,将鼠标悬停在错误上,然后单击 "查看详细信息"以查看更多信息。

  • 右侧面板将显示错误描述和解决信息。您还会看到受错误影响的记录列表。单击记录链接可访问记录并进行必要的更改。
这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助