本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 对播放进行故障排除 MediaTailor
本节提供有关在测试播放器软件时以及在正常处理播放器请求期间可能收到的 HTTP 错误代码的信息。
**注意**
在`PutPlaybackConfiguration`和之类的配置操作中，您也可能会收到来自 AWS Elemental MediaTailor API 的错误`GetPlaybackConfiguration`。有关这些错误类型的信息，请参阅 [AWS Elemental MediaTailor API 参考](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html)。
当您的玩家直接或通过 CDN 向发送请求时，会使用状态码进行 MediaTailor 响应。 AWS Elemental MediaTailor如果 MediaTailor 成功处理了请求，它将返回表示成功的 HTTP 状态代码`200 OK`以及已填充的清单。如果请求失败，则 MediaTailor 返回 HTTP 状态码、异常名称和错误消息。
AWS Elemental MediaTailor 返回两类错误：
+ **客户端错误** — 通常由请求本身的问题引起的错误，例如请求格式不正确、参数无效或网址错误。这些错误具有一个 HTTP `4xx` 响应代码。
+ **服务器错误** — 通常由依赖项问题 MediaTailor 或依赖项之一引起的错误，例如广告决策服务器 (ADS) 或源服务器。这些错误具有一个 HTTP `5xx` 响应代码。
**Topics**
+ [返回的客户端播放错误 AWS Elemental MediaTailor](#playback-errors-client)
+ [返回的服务器播放错误 AWS Elemental MediaTailor](#playback-errors-server)
+ [播放错误示例](#playback-errors-examples)
## 返回的客户端播放错误 AWS Elemental MediaTailor
一般指导：
+ 您可以在响应的标题和正文中找到大多数错误的详细信息。
+ 对于某些错误，您需要检查您的配置设置。您可以从中检索播放配置的设置 AWS Elemental MediaTailor。对于 API 来说，资源是`GetPlaybackConfiguration/Name`。有关详细信息，请参阅《AWS Elemental MediaTailor API 参考》[https://docs.aws.amazon.com/mediatailor/latest/apireference/](https://docs.aws.amazon.com/mediatailor/latest/apireference/)。
下表列出了清单操纵活动返回的客户端错误代码 AWS Elemental MediaTailor、可能的原因以及您可以采取的解决措施。
| 代码 | 异常名称 | 含义 | 操作 |
| --- | --- | --- | --- |
| 400 | BadRequestException | MediaTailor 由于格式或内容存在一个或多个错误，无法为请求提供服务。参数可能格式不正确，或者请求可能包含无效的播放配置或会话 ID。 | 检查您的请求格式是否正确，是否包含准确的信息。确保播放器上的播放终端节点设置与 GetPlaybackConfiguration 返回的 ManifestEndpointPrefix 设置相匹配。重试您的请求。 |
| 403 | AccessDeniedException | 请求中提供的主机标头与 MediaTailor 播放 URL 中配置的清单终端节点前缀不匹配。您的 CDN 可能配置错误。 | 检查您的 CDN 设置，并确保为 MediaTailor 使用正确的清单终端节点前缀。重试您的请求。 |
| 404 | NotFoundException | MediaTailor 找不到指定的信息。可能的原因包括未映射服务中任何内容的 URL，未定义的配置或不可用的会话。 | 检查您的配置和请求的有效性，然后重新初始化此会话。 |
| 409 | ConflictException | 播放器尝试同时为单个会话加载多个播放列表。结果， MediaTailor 检测到会话一致性冲突。HLS 播放器会出现此问题。 | 确保您的播放器一次请求一个播放列表。这符合 HLS 规范。 |
| 410 | Gone | Su AWS pport 操作员已屏蔽玩家会话或客户配置。 AWS 当我们检测到来自单个会话或配置的错误流量的大量 4xx 请求时，Support 会在极少数情况下执行此操作。 | 如果您认为不应阻止该请求，请联系 [AWS Support](https://aws.amazon.com/premiumsupport/)。他们可以调查问题并删除阻止筛选器（如果适用）。 |
如果您需要进一步的帮助，请联系 [AWS Support](https://aws.amazon.com/premiumsupport/)。
## 返回的服务器播放错误 AWS Elemental MediaTailor
一般指导：
+ 您可以在响应的标题和正文中找到大多数错误的详细信息。
+ 对于某些错误，您需要检查您的配置设置。您可以从中检索播放配置的设置 AWS Elemental MediaTailor。对于 API 来说，资源是`GetPlaybackConfiguration/Name`。有关详细信息，请参阅《AWS Elemental MediaTailor API 参考》[https://docs.aws.amazon.com/mediatailor/latest/apireference/](https://docs.aws.amazon.com/mediatailor/latest/apireference/)。
下表列出了清单操作活动返回的服务器错误代码 AWS Elemental MediaTailor、可能的原因以及您可以采取的解决措施。
| 代码 | 异常名称 | 含义 | 操作 |
| --- | --- | --- | --- |
| 500 | InternalServiceError | 未处理的异常。 | 重试请求。如果问题仍然存在，请检查您所在 AWS 区域报告的运行状况 MediaTailor ，网址为[https://status.aws.amazon.com/](https://status.aws.amazon.com/)。 |
| 502 | BadGatewayException | 源服务器地址或广告决策服务器 (ADS) 地址无效。无效地址如私有 IP 地址和 localhost。 | 确保您的配置具有 ADS 和源服务器的正确设置，然后重试该请求。 |
| 502 | UnsupportedManifestException | 要么源清单已更改， MediaTailor无法对其进行个性化设置，要么 MediaTailor 不支持来源的清单格式。 | 这可能仅影响单个会话。重新初始化会话。您通常可以通过在查看器中刷新页面来完成此操作。如果问题仍然存在，请验证 MediaTailor 是否支持来源的清单格式。有关信息，请参阅[集成内容源](integrating-origin.md)。 |
| 503 | LoadShed | MediaTailor 在处理您的请求时遇到了资源限制。 | 重试请求。如果问题仍然存在，请检查您所在 AWS 区域报告的运行状况 MediaTailor ，网址为[https://status.aws.amazon.com/](https://status.aws.amazon.com/)。 |
| 503 | ThrottlingException | 您的每秒交易数已达到配额， MediaTailor 会限制您的使用。 | 重试请求。您也可以通过以下网址查看您所在 AWS 地区报告的 MediaTailor 健康状况[https://status.aws.amazon.com/](https://status.aws.amazon.com/)。您可能希望提高每秒交易数的配额。有关更多信息，请参阅 [广告投放配额](quotas.md#ad-insertion-quotas)。 |
| 504 | GatewayTimeoutException | 联系源服务器 MediaTailor 时出现超时。 | 重试请求。如果问题仍然存在，请检查源服务器的运行状况，并确保源服务器在[广告投放配额](quotas.md#ad-insertion-quotas)中列出的内容源服务器超时内做出响应。 |
如果您需要进一步的帮助，请联系 [AWS Support](https://aws.amazon.com/premiumsupport/)。
## 播放错误示例
本节列出了您在与命令行交互时可能看到的播放错误的一些示例 AWS Elemental MediaTailor。
以下示例显示了广告决策服务器 (ADS) 或源服务器之间 AWS Elemental MediaTailor 发生超时时的结果。
```
~[]> curl -vvv https://111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com/v1/master/123456789012/Multiperiod_DASH_Demo/index.mpd
* Trying 54.186.133.224...
* Connected to 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com (11.222.333.444) port 555 (#0)
* TLS 1.2 connection using TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
* Server certificate: mediatailor.us-west-2.amazonaws.com
* Server certificate: Amazon
* Server certificate: Amazon Root CA 1
* Server certificate: Starfield Services Root Certificate Authority - G2
> GET /v1/master/123456789012/Multiperiod_DASH_Demo/index.mpd HTTP/1.1
> Host: 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com
> User-Agent: curl/7.43.0
> Accept: */*
>
< HTTP/1.1 504 Gateway Timeout
< Date: Thu, 29 Nov 2018 18:43:14 GMT
< Content-Type: application/json
< Content-Length: 338
< Connection: keep-alive
< x-amzn-RequestId: 123456789012-123456789012
< x-amzn-ErrorType: GatewayTimeoutException:http://internal.amazon.com/coral/com.amazon.elemental.midas.mms.coral/
<
* Connection #0 to host 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com left intact
{"message":"failed to generate manifest: Unable to obtain template playlist. origin URL:[https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/444455556666111122223333/index.mpd], asset path: [index.mpd], sessionId:[123456789012123456789012] customerId:[123456789012]"}%
```