审查记录导入错误并排除故障

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

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

请注意：您的账户可能会为每个对象使用个性化名称（例如，账户而不是公司）。本文档使用 HubSpot 的默认名称来称呼对象。

修复导入过程中的错误

在导入过程中，你会将文件列映射到 HubSpot 中的属性。如果在映射过程中发现值不正确或缺失，你可以在导入工具中更新值，而不需要编辑和重新上传文件。例如，你可以找到并修正拼写错误，或为空白单元格添加值。

要解决 "将文件中的列映射到 HubSpot 属性"屏幕上的错误，请执行以下操作

1. 要查看有关所发现错误的更多信息，请将鼠标悬停在有错误的行上，然后单击[x] 错误。在右侧面板中，查看有关错误类型的更多详细信息，包括受影响的列和行。

• • 要查看映射到的属性，请单击右上角的属性名称。

1. • 要了解特定错误的更多信息，请单击错误名称。
   • 要查看文件中受影响的行，请单击查看错误值。
   • 如果有建议的解决方案，则会出现 "修复错误 "部分。查看建议的解决方案，然后根据错误，单击编辑错误值编辑值 并修复错误。
2. 要编辑有错误的行中的值，请将鼠标悬停在有要编辑的值的行上，然后单击edit 编辑列值。在右侧面板中
   
   • 选择要替换的列值。首次打开面板时，如果检测到错误，会自动预载导致错误的值，供您修复。如果没有错误或已经编辑了列的值，则可以选择任何要替换的值。
   • 要替换值，请在替换值字段中输入或选择新值。该值将替换该列中出现该值的每一行（例如，一列中多行出现的拼写错误将在所有情况下得到修正）。

请注意：您只能选择文件前 1000 行中出现的列值。但是，当您设置替换值时，它将替换所有适用的值，包括超过 1000 行的值。

• • 要不导入所选列值而不是替换它，请单击verticalMenu 菜单图标，然后单击block 不导入此值。该列中出现的每一行都不会导入该值。
  • 要添加另一个替换值，请单击add 替换另一个值，然后选择 列值并设置替换值。
  • 要删除替换值，请单击verticalMenu 菜单图标，然后单击delete 删除替换。错误值无法删除。

• • 要重置所有替换值，请单击重置所有更改。每个选定列值的替换值都将被删除。
  • 要关闭面板，请单击完成。

3. 一旦解决了错误，映射列中就会出现success 复选标记。如果列的值已被编辑，edit Edited将出现在相应的行中。

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

查看导入

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

1. 在摘要卡上，可以查看导入的行数、创建的新记录和更新的现有记录。了解有关分析导入的更多信息。
2. 如果在导入过程中修正了枚举属性值或关联标签的错误，则会出现一个显示对值所做更改的部分。

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

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

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

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

导入文件错误

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

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

模棱两可的枚举选项

错误含义

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

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

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

如何解决错误

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

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

未找到关联标签

错误含义

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

如何解决该错误

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

超出关联限制

错误含义

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

如何解决错误

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

未找到关联记录

错误含义

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

如何解决错误

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

找不到所有者

错误含义

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

如何解决该错误

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

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

无法解析日期

错误含义

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

如何解决该错误

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

无法解析数字

错误含义

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

如何解决该错误

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

无法解析记录

错误含义

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

如何解决错误

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

无法解析术语

错误含义

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

如何解决该错误

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

只创建导入

错误的含义

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

如何解决错误

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

重复的备用 ID

错误含义

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

如何解决错误

• 为避免重复，联系人使用电子邮件，公司使用公司域名，任何对象使用记录 ID 。
• 要关联记录，可使用电子邮件、公司域名、记录 ID，或选择一对多属性，其中一个值对与之关联的许多记录而言是唯一的（例如，以公司名称为唯一值，该值将与在同一公司工作的许多联系人关联）。有关进一步指导，请参阅示例导入文件 。

重复关联 ID

错误含义

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

如何解决该错误

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

重复记录 ID

错误含义

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

如何解决该错误

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

重复的行内容

错误含义

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

如何解决该错误

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

重复的唯一属性值

错误含义

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

如何解决错误

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

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

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

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

创建关联失败

错误含义

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 导入错误

1. 在 HubSpot 帐户中，导航到数据管理 > 数据集成。 出现错误。
2. 将鼠标悬停在有错误的 Salesforce 导入上，然后单击查看导入错误。
3. 在 "导入错误"表中，将鼠标悬停在错误上，然后单击 "查看详细信息"以查看更多信息。

5. 右侧面板将显示错误描述和解决信息。您还会看到受错误影响的记录列表。单击记录链接可访问记录并进行必要的更改。