• AWS Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。
# AWS Systems Manager Distributor 故障排除
以下信息可帮助排查使用 Distributor（AWS Systems Manager 中的一项工具）时可能出现的问题。
**Topics**
+ [安装了具有相同名称的错误的软件包](#distributor-tshoot-1)
+ [错误：“无法检索清单：找不到软件包的最新版本”](#distributor-tshoot-2)
+ [错误：“无法检索清单：验证异常”](#distributor-tshoot-3)
+ [软件包不受支持（软件包缺少安装操作）](#distributor-tshoot-4)
+ [错误：无法下载清单：带有名称的文档不存在](#distributor-tshoot-5)
+ [上传失败。](#distributor-tshoot-6)
+ [错误：找不到平台：找不到平台清单：oracle，版本 8.9，架构 x86\$164](#distributor-tshoot-7)
## 安装了具有相同名称的错误的软件包
**问题：**您已安装了一个软件包，但 Distributor 安装了一个不同的软件包。
**原因：**在安装过程中，Systems Manager 先查找 AWS 发布的软件包作为结果，然后才查找用户定义的外部软件包。如果用户定义的软件包名称与 AWS 发布的软件包名称相同，则将安装 AWS 软件包而不是您的软件包。
**解决方案：**要避免此问题，请将您的软件包命名为与 AWS 发布的软件包不同的名称。
## 错误：“无法检索清单：找不到软件包的最新版本”
**问题：**您收到类似如下内容的错误。
```
Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package
arn:aws:ssm:::package/package-name status code: 400, request id: guid
```
**原因：**您使用的 SSM Agent 版本的 Distributor 版本低于 2.3.274.0。
**解决方案：**将 SSM Agent 版本更新为 2.3.274.0 或更高版本。有关更多信息，请参阅 [使用 Run Command 更新 SSM Agent](run-command-tutorial-update-software.md#rc-console-agentexample) 或 [演练：使用 AWS CLI 自动更新 SSM Agent](state-manager-update-ssm-agent-cli.md)。
## 错误：“无法检索清单：验证异常”
**问题：**您收到类似如下内容的错误。
```
Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:region-id:account-id:package/package-name
```
**原因：**您使用的 SSM Agent 版本的 Distributor 版本低于 2.3.274.0。
**解决方案：**将 SSM Agent 版本更新为 2.3.274.0 或更高版本。有关更多信息，请参阅 [使用 Run Command 更新 SSM Agent](run-command-tutorial-update-software.md#rc-console-agentexample) 或 [演练：使用 AWS CLI 自动更新 SSM Agent](state-manager-update-ssm-agent-cli.md)。
## 软件包不受支持（软件包缺少安装操作）
**问题：**您收到类似如下内容的错误。
```
Package is not supported (package is missing install action)
```
**原因：**软件包目录结构不正确。
**解决方案：**不要压缩包含软件和所需脚本的父目录。相反，应直接在绝对路径中创建一个包含所有所需内容的 `.zip` 文件。要验证是否已正确创建 `.zip` 文件，请解压缩目标平台目录，并审核目录结构。例如，安装脚本绝对路径应为 `/ExamplePackage_targetPlatform/install.sh`。
## 错误：无法下载清单：带有名称的文档不存在
**问题：**您收到类似如下内容的错误。
```
Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name filename does not exist.
```
**原因 1：**在共享来自其他账户的 Distributor 软件包时，Distributor 无法通过软件包名称找到该软件包。
**解决方案 1：**在共享来自其他账户的软件包时，请使用软件包的 Amazon 资源名称（ARN），而不只是软件包名称。
**原因 2：**在使用 VPC 时，没有向自己的 IAM 实例配置文件提供对 AWS 托管式 S3 存储桶的访问权限，而该存储桶包含目标 AWS 区域适用的 `AWS-ConfigureAWSPackage` 档案。
**解决方案 2：**确保自己的 IAM 实例配置文件提供向 SSM Agent 提供了对 AWS 托管式 S3 存储桶（该存储桶包含目标 AWS 区域适用的 `AWS-ConfigureAWSPackage` 文档）的访问权限，如 [SSM Agent 与 AWS 托管 S3 存储桶进行通信](ssm-agent-technical-details.md#ssm-agent-minimum-s3-permissions)中所述。
## 上传失败。
**问题**：您收到类似如下内容的错误：
```
Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.
```
**原因：**您软件包的名称中包含空格。例如，`Hello World.msi` 将无法上传。
## 错误：找不到平台：找不到平台清单：oracle，版本 8.9，架构 x86\$164
**问题**：您收到类似如下内容的错误：
```
Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86_64
```
**原因：**此错误表示 JSON 软件包清单没有该平台（在本例中为 Oracle Linux）对应的任何定义。
**解决方法：**从 [Trend Micro Deep Security Software](https://help.deepsecurity.trendmicro.com/software.html) 网站下载要分发的软件包。使用 [使用简单工作流创建软件包](distributor-working-with-packages-create.md#distributor-working-with-packages-create-simple) 创建 `.rpm` 软件包。为软件包设置以下值，然后使用 Distributor 完成软件包上传：
```
Platform version: _any
Target platform: oracle
Architecture: x86_64
```