**支援結束通知：**2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 (端點、區段、行銷活動、旅程和分析)。如需詳細資訊，請參閱 [Amazon Pinpoint 終止支援](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：**與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 區段故障診斷
<a name="segments-troubleshooting"></a>

確認已開啟記錄功能，以協助識別失敗的原因。詳情請參閱[監控和記錄](troubleshooting.md#troubleshooting-logging)。

## 客群匯入失敗
<a name="troubleshooting-segment-import"></a>

如果區段匯入失敗，您可能會看到下列錯誤訊息或類似訊息：

**匯入任務**：檔案 SampleTemplate.csv 與客群名稱 SampleTemplate 匯入失敗。錯誤的請求：我們收到的資料，與我們預期的 createImportJob 操作格式不符。確認請求中的資訊格式正確，然後重新提交請求。

****問題與解決方案****
+ 當匯入的範本格式不正確時，就會發生此錯誤。
+ 確認範本是否是有效的 JSON 或 CSV 格式。如需正確格式的範例，請參閱 [客群檔案](segments-importing.md#segments-importing-examples-files)。範例範本也可以從主控台下載。在專案下，選取**客群**、**建立客群**、**匯入客群**，然後選取**下載範例 CSV**。
+ 驗證所有指定的屬性都有效。匯入客群時，**ChannelType**和**位址**是必填欄位。屬性名稱區分大小寫。如需可加入範本的可能屬性的完整清單，請參閱 [支援的屬性](segments-importing.md#segments-importing-available-attributes)。

## 客群匯出失敗
<a name="troubleshooting-segment-export"></a>

****問題與解決方案****
+ 從主控台執行此動作時，大型匯出任務可能會失敗。
+ 為了突破此限制，您可以透過命令列參考 (CLI) 或 SDK，使用 [CreateExportJob](https://docs.aws.amazon.com//pinpoint/latest/apireference/apps-application-id-jobs-export.html#apps-application-id-jobs-exportpost) API 將客群匯出到 Amazon S3 儲存貯體。

## 動態區段的端點計數
<a name="troubleshooting-dynamic-segment"></a>

****問題與解決方案****
+ 使用動態客群建立行銷活動時，端點計數的數量是近似值，可能不準確。這是因為動態區段中的端點資料可能會根據定義的條件隨著時間而變更。可以匯出客群，以確認端點在指定時間的確切數目。

## BadRequestException：超出每個使用者計數的端點上限：15
<a name="troubleshooting-badrequestexception"></a>

若嘗試新增與同一個 `UserId` 相關聯的端點不只 15 個時，會發生此錯誤。

**注意**  
如果新端點的通道類型是 ADM、GCM、APNS、APNS\$1VOICE、APNS\$1VOIP\$1SANDBOX 或 BAIDU，且已有的端點屬於上述任一通道類型，請求將會成功。詳情請參閱*《Amazon Pinpoint 開發人員指南》*中的[管理受眾成員端點數上限](https://docs.aws.amazon.com/pinpoint/latest/developerguide/audience-define-auto-inactive.html)。

****問題與解決方案****
+ 使用 [update-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/update-endpoint.html) API 建立新端點或編輯現有端點，且特定端點超過 15 個端點地址的數目上限時，可能會看到此錯誤。
+ 此限制目前是該服務的硬性限制。不能增加。詳情請參閱[端點配額](https://docs.aws.amazon.com//pinpoint/latest/developerguide/quotas.html#quotas-endpoint)。

## 呼叫 UpdateEndpointsBatch 或 UpdateEndpoints 操作時出現 BadRequestException：自訂屬性過多
<a name="troubleshooting-attributes"></a>

嘗試新增不只 250 個屬性時，會發生此錯誤。每個端點的自訂屬性，最大可達 15 KB。

****問題與解決方案****
+ 匯出並檢查客群，確認自訂屬性的數目。
+ 為了協助解決例外狀況，請參閱[如何解決 Amazon Pinpoint 中的「太多屬性」錯誤？](https://repost.aws/knowledge-center/pinpoint-additional-attributes)