上次更新时间： 2026年3月6日
HubSpot 与 Salesforce 的集成可能会遇到同步错误，导致数据无法同步。您可以在 Salesforce 集成设置中识别并解决这些同步错误。
调整API调用限制
- 在 HubSpot 帐户中，单击顶部导航栏中的设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
- 在已连接的应用列表中，点击Salesforce。
- 导航至"同步状态"选项卡。
- 在"API调用使用情况"区域查看过去24小时内的API调用次数。"Salesforce限制值"即基于您Salesforce设置可执行的API调用次数上限。若需调整分配给HubSpot的调用配额，请编辑"分配给HubSpot"字段。
查看 Salesforce 同步错误
- 在 HubSpot 帐户中，单击顶部导航栏中的设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
- 在已连接的应用列表中，点击Salesforce。
- 导航至“同步状态”选项卡。
- 在"同步错误"下，查看各类错误的卡片，其中显示当前错误数量及受影响记录数。点击某类错误卡片，右侧面板将显示详细错误信息。了解各类错误的具体说明及解决建议。
- 要查看错误的更多详情，请点击错误类型列中的 信息图标 。
- 要对单条记录采取操作，请点击"受影响记录" 列中的[#]条记录 ，然后点击操作>创建 HubSpot 记录临时视图，生成受 影响记录的筛选视图。
- 解决错误后，请返回错误列表。勾选已解决错误左侧的复选框，点击重新同步。
- 要导出错误，请点击错误列表左上角的"导出错误（CSV） "。
Salesforce同步错误类型
关联错误
关联错误示例
- 关联限制已达上限
- 等待账户同步
错误含义说明
记录无法同步是因为它们关联的 Salesforce 账户尚未同步到 HubSpot 公司，或者因为它们关联的记录已达到 HubSpot 的记录关联限制。
错误解决方法
若要解决"关联限制已达上限"错误，可移除部分关联记录或将其关联至其他Salesforce记录，随后继续执行同步操作。
解决"等待账户同步 "错误 时，建议运行Salesforce账户导入操作。
自定义代码
自定义代码错误示例
- Salesforce自动化
- 缺少联系人ID
- Salesforce 自定义字段验证规则
- Salesforce流程
错误含义说明
由于 Salesforce 账户中的自动化流程、流程或验证规则导致的问题，记录无法同步。
如何解决错误
由于这些错误源自 Salesforce，建议您与 Salesforce 管理员协作，在 Salesforce 的自定义代码中解决该问题。
重复项
重复记录错误示例
- 电子邮件已被使用
- Salesforce 重复规则
错误含义
Salesforce 中的潜在客户或联系人无法同步至 HubSpot，因为该电子邮件地址已在 HubSpot 联系人记录中存在，或受Salesforce 中的去重规则限制。
错误解决方法
要解决"电子邮件已被使用"错误，请从现有HubSpot联系人中移除该电子邮件地址。
若要解决Salesforce 重复规则错误 ，建议 Salesforce 管理员检查系统中设置的去重匹配规则。 随后需合并、更新或删除冲突的 Salesforce 记录，或调整 Salesforce 中的去重规则，再尝试在 HubSpot 中重新同步。
权限
权限错误示例
- 权限不足或缺少 Salesforce 记录
- Salesforce 字段权限
- Salesforce 访问权限不足
错误含义
由于关联用户在 Salesforce 中无权访问所需字段或对象，因此无法将 HubSpot 中的更改同步到 Salesforce。
解决方法
大多数情况下，当集成尝试使用错误值更新 Salesforce 字段或创建错误关联时，会出现“访问权限不足或缺少 Salesforce 记录”错误 。
要解决Salesforce 字段权限错误 ，请确保 Salesforce 集成用户在 Salesforce 中对该字段拥有读取和编辑权限。
当 Salesforce 集成用户因自身权限限制无法执行操作时，将触发“Salesforce 权限不足”错误 。建议您在 Salesforce 中核查集成用户的权限设置。
下拉列表
下拉列表错误示例
- 缺少 Salesforce 下拉列表选项
- 州/省或国家值不匹配
- 选项不匹配
- Salesforce 所有者处于非活动状态
- 受限下拉列表值
- 机会阶段已停用
- Salesforce所有者未同步
- 选项限制超出
- 商机阶段缺失或无效
错误含义
由于HubSpot和Salesforce中的下拉列表字段值存在差异，导致记录无法同步。这种情况可能发生在：某系统中的下拉列表值与另一系统中任何现有值都不匹配、下拉列表达到值限制，或传递的值无效。
错误解决方法
为解决"州/省份值不匹配"错误，建议确认满足以下要求：
- HubSpot中国家属性选项的内部值必须与 Salesforce中州/省/地区下拉列表设置中的现有国家选项匹配。
- 州值必须作为 Salesforce 中记录国家值的可用州/省选项存在。此外，HubSpot中州属性选项的内部值必须与 Salesforce 中现有的州选项匹配。
为解决选项不匹配错误，建议将 Salesforce 字段选项的内部/API 名称更新为与 HubSpot 属性选项的内部值一致。
解决"Salesforce所有者非活跃"错误时，请将HubSpot记录重新分配给Salesforce中的活跃用户。
当 Salesforce 字段启用了“限制下拉列表为值集定义的值”设置时，会出现受限下拉列表值错误。若此设置在Salesforce 中启用，则您尝试从 HubSpot 同步至 Salesforce 的值必须作为选项存在于 Salesforce 下拉列表中。 建议您在 Salesforce 中关闭“将下拉列表限制为值集定义的值”设置，以便允许任何值从 HubSpot 同步至 Salesforce。
当Salesforce商机处于非活动阶段时尝试同步至HubSpot，将引发 "非活动商机阶段"错误 。解决方法：在Salesforce中将商机阶段改为活动状态，或将商机移至活动阶段。
解决"Salesforce所有者未同步"错误时，请确保Salesforce用户类型设置为标准用户、高级合作伙伴或访客。
解决选项限制超出错误时，建议删除团队未使用的HubSpot和Salesforce中多余的属性选项。同时确保所有映射属性均对应正确字段类型。
大多数情况下，"默认销售流程不可用 "错误 发生于Salesforce商机尝试同步至HubSpot时缺少记录类型。若您已在Salesforce启用记录类型但未使用，或存在无记录类型的Salesforce商机，建议您与Salesforce协作停用所有记录类型或创建新记录类型。
为解决"商机阶段缺失或无效"错误，请确保Salesforce商机阶段值在HubSpot销售管道中存在。
属性映射
属性映射错误示例
- 类型不匹配
- 缺少 Salesforce ID
- 无效的 Salesforce ID
错误含义
由于 HubSpot 属性与 Salesforce 字段的映射存在差异，导致记录无法同步。这可能意味着属性与字段类型不兼容、属性或字段已不存在，或者需要创建 Salesforce 引用字段映射。
错误解决方法
要解决类型不匹配错误，请确保HubSpot中的属性类型与Salesforce中的字段类型兼容。了解可同步至Salesforce的HubSpot属性字段类型。
当HubSpot尝试将非现有Salesforce ID的值同步至Salesforce的引用/查找字段时，将触发"缺少Salesforce ID"错误。
为解决无效 Salesforce ID错误，建议检查您在 Salesforce 中设置的自定义验证规则。
属性值
属性值错误示例
- 字符串过长
- 电子邮件无效
- 缺少必需的国家/地区
- 无效值
- 所有者分配
- 受限唯一值
- 缺少必需值
错误含义
由于包含无效属性值，记录无法在HubSpot与Salesforce之间同步。此类错误通常需要手动更新受影响的记录以修正问题。
错误解决方法
要解决字符串过长错误，请缩短 Salesforce 或 HubSpot 中的字段值，或增加 Salesforce 中该字段的字符限制。
解决"无效电子邮件 "错误 ：更新尝试同步至HubSpot的Salesforce记录中的电子邮件地址格式。
解决"缺少必填国家/地区"错误时，建议确认满足以下要求：
- HubSpot中国家属性选项的内部值必须与 Salesforce中州/省份和国家/地区下拉列表设置中的现有国家选项匹配。
- 州值必须作为记录国家值在Salesforce中可用的州/省选项存在。此外，HubSpot中州属性选项的内部值必须与Salesforce中现有的州选项匹配。
解决无效值错误时，建议更新Salesforce记录中的属性值以符合HubSpot对该属性值的要求。
大多数情况下，当HubSpot活动同步至Salesforce作为任务时，若HubSpot尝试将该任务分配给Salesforce队列所有者，则会触发"所有者分配错误 "。
为解决“受限唯一值”错误，建议检查您在Salesforce中设置的去重匹配规则。
为解决"缺少必填值错误"，请为HubSpot中标记为必填的任何属性在Salesforce记录中添加值。
其他
记录因未知错误未同步。请联系HubSpot支持团队获取进一步协助。
请注意：每次最多可批量重新同步100个Salesforce错误。若需同步超过100个错误，请从Salesforce导入记录或更新已映射的属性。
设置同步错误通知
- 在 HubSpot 帐户中，单击顶部导航栏中的设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
- 在已连接的应用列表中，点击Salesforce。
- 导航至“同步状态”选项卡。
- 在"同步错误"下，点击"管理通知"。
- 在对话框中，开启"启用通知"开关。
- 选择“即时”、“每日”或“每周”旁的单选按钮以设置通知频率。
- 点击保存。
