**终止支持通知：** AWS 将于 2026 年 10 月 30 日终止对亚马逊 Pinpoint 的支持。2026 年 10 月 30 日之后，您将不再能够访问 Amazon Pinpoint 控制台或 Amazon Pinpoint 资源（端点、分段、活动、旅程和分析）。有关更多信息，请参阅 [Amazon Pinpoint 终止支持](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：** APIs 与短信相关、语音、移动推送、OTP 和电话号码验证不受此更改的影响，并受 AWS 最终用户消息的支持。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 对客户细分进行故障排除
<a name="segments-troubleshooting"></a>

确认日志记录开启，以帮助您确定失败原因。有关更多信息，请参阅[监控和日志记录](troubleshooting.md#troubleshooting-logging)。

## 客户细分导入失败
<a name="troubleshooting-segment-import"></a>

如果客户细分导入失败，您可能看到以下错误消息或类似消息：

**导入任务**：使用区段名称 SampleTemplate的 SampleTemplate .csv 文件导入失败。错误请求：我们收到的数据与我们预期的 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>

****问题和解决方案****
+ 从控制台执行此操作时，大型导出作业可能会失败。
+ 要解决此限制，可以使用 [CreateExportJob](https://docs.aws.amazon.com//pinpoint/latest/apireference/apps-application-id-jobs-export.html#apps-application-id-jobs-exportpost)API 通过命令行参考 (CLI) 或 SDK 将区段导出到 Amazon S3 存储桶。

## 动态客户细分的端点计数
<a name="troubleshooting-dynamic-segment"></a>

****问题和解决方案****
+ 当您在创建活动过程中使用动态客户细分时，端点的数量是个近似值，可能不准确。这是因为动态客户细分中的端点数据会随着时间以及定义的标准而变化。可以导出客户细分来确认给定时间点的确切端点数量。

## BadRequestException: 已超过每个用户的最大端点数：15
<a name="troubleshooting-badrequestexception"></a>

当尝试添加 15 个以上与同一 `UserId` 关联的端点时，就会发生此错误。

**注意**  
如果新端点的渠道类型为 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)。

## BadRequestException 调用 o UpdateEndpointsBatch r UpdateEndpoints 操作时：自定义属性太多
<a name="troubleshooting-attributes"></a>

当尝试添加超过 250 个属性时，就会发生此错误。自定义属性可以为每个端点最多 15 KB。

****问题和解决方案****
+ 导出客户细分并进行检查以确认自定义属性的数量。
+ 要帮助解决异常，请参阅 [How do I resolve a "too many attributes" error in Amazon Pinpoint?](https://repost.aws/knowledge-center/pinpoint-additional-attributes)