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

在将记录或活动导入HubSpot 时，您可能会遇到错误。以下内容将指导您如何解决导入过程中检测到的错误、下载错误文件、查看错误详情，以及在导入文件或 Salesforce 中修正问题。

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

请注意：您的账户可能为每个对象使用个性化名称（例如使用 account 代替 company）。本文档采用 HubSpot 默认名称指代对象。

导入过程中

修复错误

导入过程中，您需将文件列映射至HubSpot属性。若发现映射值错误或缺失，可直接在导入工具内更新值，无需编辑并重新上传文件。例如可查找并修正拼写错误，或为空白单元格添加值。

在"将文件列映射至HubSpot属性"界面解决错误的方法：

1. 要查看更多错误信息，请将鼠标悬停在含错误的行上，然后点击[x]个错误。在右侧面板中，可查看错误类型的详细信息，包括受影响的列和行。
   
   • 要查看映射目标属性，请点击右上角的属性名称。
   • 要了解具体错误详情，请点击错误名称。
   • 查看文件中受影响的行，请点击查看错误值。
   • 若存在推荐解决方案，系统将显示"修复错误 "区域 。查看建议方案后，根据错误类型点击"编辑错误值"修改数值以修复错误。
2. 要编辑含错误行中的值，请将鼠标悬停在需修改值的行上，然后点击编辑列值。在右侧面板中：
   
   • 选择要替换的列值。首次打开面板时，若检测到错误，系统将自动预加载导致错误的值供您修正。若无错误或该列值已编辑过，可选择任意值进行替换。
   • 在替换值字段中输入或选择新值即可完成替换。该值将覆盖该列所有行中的对应值（例如：某列多行出现的拼写错误将被统一修正）。

   

   请注意：您仅能选择文件前1000行中出现的列值。但设置替换值后，该值将替换所有适用项，包括第1000行之后的值。

   • 若需屏蔽特定列值而非替换，请点击 垂直菜单图标，选择" 屏蔽此值 "。该列中出现该值的行将不被导入。
   • 要添加其他替换值，请点击“添加 其他替换值”，选择 列值并设置替换值。
   • 要删除替换值，请点击垂直 菜单图标，选择"删除替换值"。错误值不可删除。
     
   • 若需重置所有替换设置，请点击“重置所有更改”。此时所选列的所有替换值将被清除。
   • 要关闭面板，请点击完成。
3. 错误修复后，映射列将显示成功 勾号。若列值被编辑过，对应行将显示编辑标记。

请注意：若文件超过1,000行，可能存在未解决的额外错误。

查看导入记录

导入完成后，系统将自动跳转至导入摘要页面，其中包含错误概览。您也可查看历史导入记录的摘要。

1. 在摘要卡片中，可查看导入行数、新建记录数及更新现有记录数。了解更多导入分析信息。
   • 在某些情况下，新增或更新的记录数可能与导入行数不符。
   • 例如：若导入数据包含关联单条记录的多封邮件，则次要邮件将更新现有记录而非创建全新记录。此时新增/更新记录数将少于导入行数。 

1. 若您在导入过程中修正了枚举属性值或关联标签的错误，系统将显示专门区域展示您对这些值所做的修改。

3. 若导入过程中出现错误，则会显示" 导入错误"部分。在表格中可查看以下信息：
   • 文件导入列：受错误影响的文件列标题。 
   • 对象类型：分配给受影响列的CRM对象或 活动。
   • HubSpot属性：与受影响列匹配的HubSpot属性。
   • 错误类型：受影响列的具体错误类型。了解所有 导入错误详情 。
   • 错误影响：因错误导致未导入的行数或属性值数量。若整行未导入，表示该行所有列均无法导入；若单个值未导入，表示该属性列的值无法导入，但该行其他列仍可导入。

4. 要查看特定错误的详细信息，请将鼠标悬停在该行上，然后点击查看详情。
5. 要查看所有包含错误的行，请点击查看含错误的行。在含错误的行页面：
   • 在表格中查看行及其包含的错误。受错误影响的列将显示感叹号 警报图标。点击最左侧列中的错误名称可查看错误原因及解决方法。
   • 点击“下载包含错误的行”可下载受影响行及其错误信息。点击下载的zip文件解压CSV文件后即可打开查看。
6. 若需下载错误列表文件，请在表格上方点击“将错误下载为文件”。 
   • 点击下载的zip文件解压CSV文件，然后打开该文件。
   • 在文件中，通过以下列识别具体信息：-错误代码列：对应错误代码-对象类型列 ：显示受影响记录的对象类型-原因列 ：说明错误缘由- 其他列：包含记录的属性值

请注意：导入错误中的敏感数据将在导入后界面及下载的错误文件中被替换为"REDACTED"字样。如需查看原始值，请参阅您的原始导入文件。

识别导入错误后，请了解如何解决具体错误。

导入文件错误

以下按字母顺序列出的错误代码包含错误详情及可能的解决步骤。 部分情况下，存在错误的记录或活动仍可导入，您可在HubSpot中修正，或修改导入文件后重新导入。其他情况下，记录或活动将无法导入，需修正导入文件后才能重新导入。

请注意： 下载文件中的错误代码 包含大写字母和下划线字符，但本文中以常规文本形式列出。 例如，文件中显示的错误为 AMBIGUOUS_ENUMERATION_OPTION，但在下方列表中对应为" 枚举选项含糊不清"。

枚举选项含糊不清

错误含义

同一记录匹配了枚举属性中定义的多个现有选项。此情况适用于多选、下拉选择、单选按钮和复选框类型的属性。

若导入文件中的值为属性选项的标签而非内部值，也可能引发此错误。此情况适用于标签与内部值不一致的枚举属性选项。

受影响记录已导入，但枚举属性未包含有效值。

解决方法

通过比对导入文件与HubSpot中的属性值，识别错误值。 请将导入文件中的值更新为仅匹配一个现有选项，或更新为选项的内部值（若标签与内部值不一致）。更新后重新导入文件。

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

关联标签未找到

错误含义

导入过程中某列包含关联标签，但该标签在HubSpot中不存在。数据虽已导入，但生成的关联关系未被标记。

解决方法

通过比对导入文件与HubSpot中的关联标签，识别错误值。确保您的值与现有标签匹配，或创建新标签。 若导入配对标签，请确保对应对象使用正确标签（例如：雇主应用于公司，员工应用于联系人）。完成后重新导入文件或手动更新 受影响记录的标签 。

关联限制超出

错误说明

您曾为记录间允许的总关联数或带标签关联数设置限制，但本次导入包含超出限制的关联。 数据虽已导入，但关联关系未在HubSpot中建立。

解决方法

若记录需建立关联或需通过特定标签定义关联，请更新关联限制后重新导入文件，或在HubSpot中手动更新关联关系。

关联记录未找到

错误说明

导入过程中，某列被映射至用于关联记录的唯一标识属性（如记录ID、邮箱、公司域名或自定义唯一值属性）。但文件中未包含必需的唯一值。若使用含换行符或超过100个字符的唯一标识值，也会导致此问题。 数据已导入，但生成的记录在HubSpot中未建立关联。

解决方法

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

未找到所有者

错误含义

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

解决方法

确认目标记录分配对象为账户内活跃用户，然后在导入文件的"所有者"列中更新该用户的姓名或邮箱。

• 若目标人员尚未成为账户用户，请先将其添加为用户，再使用账户中显示的姓名或邮箱重新导入。
• 若目标用户已被停用， 请先重新激活该用户，再使用账户中对应的姓名或邮箱重新导入。

无法解析日期

错误含义

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

解决方法

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

无法解析数字

错误说明

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

错误解决方法

将导入文件中的数值修正为正确格式后重新导入，或手动更新 受影响记录的属性值 。

无法解析行

错误含义

导入文件中存在无法处理的数据行。若该属性为必填项， 则记录未被导入；若非必填项，记录虽被导入但该属性值为空。

错误解决方法

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

。

无法解析期限

错误含义

导入文件中的时间段值不符合允许的期限格式。受影响记录仍被导入，但期限属性未包含值。 

错误解决方法

将文件中的期限值修改为整月数或ISO8601时长格式（例如三年六个月四天应表示为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默认枚举属性（如生命周期阶段、行业），请确保值与英文选项标签或其内部值完全匹配。您可选择：更新导入文件中的值使其符合现有选项，或将该值作为自定义选项添加至属性。操作完成后，请重新导入文件或手动更新 受影响记录的属性值 。

无效事件

错误含义

在导入自定义事件或 营销事件时，导入文件包含无效事件（例如开始时间晚于结束时间的事件）。受影响的行未被导入。

解决方法

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

无效事件时间戳

错误含义

针对自定义事件导入，导入文件中"发生时间"属性的时间戳为空或无效。受影响行已导入，但该属性未包含值。

解决方法

添加或更新符合时间戳范围（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"姓名）。受影响记录已导入，但所有者属性 未填入值。

解决方法

在导入文件中将所有者名称替换为对应邮箱地址，然后重新导入文件。您也可手动更新 受影响记录中的所有者 属性值。

超出有效期限范围

错误说明

导入文件中的时间段值超出允许的期限范围。受影响记录虽已导入，但期限属性未包含有效值。 

错误解决方法

将文件中的期限值更新为有效时间范围（大于等于1个月的整数），然后重新导入文件。您也可以手动更新 受影响记录中的属性值 。

超出有效时间范围

错误说明

导入文件中包含的时间段值超出允许的时间范围。 受影响记录已导入，但时间范围属性未包含数值。

错误解决方法

将文件中的时间范围值调整至有效区间（小于1000年），然后重新导入文件。您也可手动更新 受影响记录的属性值 。

全站自定义对象存储上限超限

错误说明

因 该自定义对象 的存储记录数已达上限， HubSpot无法创建记录。您的数据未被导入。

解决方法

若存在不再需要的记录，请删除该自定义对象内的记录后重新导入文件。如需增加存储空间，可购买自定义对象记录存储上限扩容服务。 了解有关您的HubSpot 订阅及其限制的更多信息。

未找到属性定义

错误说明

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

解决方法

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

属性验证规则错误

错误说明

导入文件中的某个值不符合属性验证规则要求（例如包含特殊字符、过长或过短等）。受影响记录已导入，但该属性未填入值。

解决方法

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

。

缺少必填属性

错误说明

导入文件缺少必填属性的值。该行数据未被导入。

错误解决方法

更新导入文件，为必填属性添加有效值，然后重新导入文件。

行数据过大

错误说明

文件中某单元格或行包含超过1MB的数据，超出导入工具处理能力。该行数据未被导入。

解决方法

缩小文件中受影响单元格或行数据的体积，然后重新导入文件。

未知错误请求

错误说明

导入文件包含无效的记录ID，该ID与 HubSpot账户中任何现有记录均不匹配。由于数据与现有记录不符，导入操作未更新该记录。

解决方法

请确认 记录ID正确无误。若发现ID错误，请在导入文件中更新为正确记录ID后重新导入。

未知错误

错误说明

HubSpot因未知错误无法处理文件，数据未被导入

。

解决方法

请确认文件满足所有要求。 清除浏览器缓存或切换浏览器后尝试重新导入。若仍出现错误，请在社区发帖（面向全体用户）或联系支持团队（仅限Starter /Professional/Enterprise账户）。

仅更新导入

错误含义

您选择仅更新现有记录，但导入文件中的唯一标识符值与HubSpot现有记录不匹配。 例如：导入的电子邮件值与现有联系人邮箱不符，或记录ID值与现有记录不匹配。受影响行未被导入，因此未创建新记录，但现有记录已更新。

错误解决方法

若受影响值本应匹配现有记录，请确认值拼写正确或包含正确的记录ID编号。修正文件中的错误后重新导入。

若您的目标仅为更新现有记录而非创建新记录，则无需采取任何措施。若希望受影响行创建新记录，请重新导入文件并在导入过程中选择"创建新记录并更新现有记录"选项。

Salesforce导入错误

1. 在 HubSpot 帐户中，导航到数据管理 > 数据集成。
2. 将鼠标悬停在存在错误的 Salesforce 导入项上，点击查看导入错误。 
3. 在"导入错误"表格中，将鼠标悬停在某个错误上并点击"查看详情"可获取更多信息。
4. 右侧面板将显示错误描述及解决方法，同时列出受影响的记录列表。点击记录链接即可访问该记录并进行必要修改。