文档

由于架构引用无效，流式摄取失败

Last update: Tue Jan 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

在Adobe Experience Platform中，使用流端点时，流摄取可能会失败。 该错误指出无法验证消息，因为它与数据集的架构引用不匹配。 当有效负载中的架构引用不正确或格式不正确时，会出现此问题，通常是因为在复制粘贴操作（使用UI中的复制架构有效负载）期间引入额外的字符。 更正架构引用可解决验证错误，并允许继续摄取数据。 要修复此问题，请查看有效负载中的schemaRef.id，删除任何不需要的字符，然后重新发送更正后的请求。

描述 description

环境

Adobe Experience Platform

问题/症状

  • 流式摄取尝试失败，并出现验证错误。
  • 错误消息指示消息与数据集的架构引用不匹配。
  • 失败的记录显示schemaRef在架构URL的末尾包含意外的URL编码双引号(%22)。

解决方法 resolution

要解决此问题，请执行以下步骤：

  1. 在AEP中，查看为流式摄取发送的有效负载。
  2. 检查标头部分并找到schemaRef.id值。
  3. 从schemaRef.id的末尾删除所有无关字符，如URL编码的双引号(%22)。
  4. 确保schemaRef.id与数据集的预期架构URL匹配，而不使用其他字符。
  5. 使用更正后的标头重新发送流有效负载。
  6. 验证数据摄取是否成功，以及是否发生验证错误。

注意：从其他源复制值时经常出现此问题，这可能会无意中将不需要的字符引入配置字段。 在API请求或配置文件中使用URL和标识符之前，请始终确认它们没有编码工件。

相关阅读

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f