文件

串流內嵌因無效的結構描述參考而失敗

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和識別碼之前，請務必確認URL和識別碼沒有編碼成品。

相關閱讀

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