Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Amazon SAM CLI 故障排除

本节详细介绍了在使用、安装和管理 Amazon Serverless Application Model 命令行界面时如何对错误消息进行故障排除 (Amazon SAM CLI).

故障排除

有关以下内容的疑难解答指南 Amazon SAM CLI，请参阅 排查 安装错误。

错误消息

Curl 错误：“curl：(6) 无法解析：...”

尝试调用 API Gateway 端点时，您遇到以下错误：

curl: (6) Could not resolve: endpointdomain (Domain name not found)

这意味着您向一个无效的域发送了请求。如果您的无服务器应用程序未能成功部署，或者您的 curl 命令中有错别字，则可能会发生这种情况。使用 Amazon CloudFormation 控制台或验证应用程序是否成功部署 Amazon CLI，并验证您的curl命令是否正确。

错误：找不到具有给定堆栈名称的确切资源信息

在包含单个 Lambda 函数资源的应用程序中运行 sam remote invoke 命令时，您遇到以下错误：

Error: Can't find exact resource information with given <stack-name>. Please provide full resource ARN or --stack-name to resolve the ambiguity.

错误：无法从堆栈名称中找到资源信息

运行 sam remote invoke 命令并将 Lambda 函数 ARN 作为参数传递时，您遇到以下错误：

Error: Can't find resource information from stack name (<stack-name>) and resource id (<function-id>)

错误：无法创建托管资源：无法找到凭证

运行 sam deploy 命令时，您遇到以下错误：

Error: Failed to create managed resources: Unable to locate credentials

这意味着您尚未设置 Amazon 凭据来启用 Amazon SAM CLI 拨打 Amazon 服务电话。要解决此问题，您必须设置 Amazon 凭据。有关更多信息，请参阅 设置 Amazon 凭证。

错误： FileNotFoundError 在 Windows 中

在中运行命令时 Amazon SAM CLI 在 Windows 上，你可能会看到以下错误：

Error: FileNotFoundError

可能的原因： Amazon SAM CLI 可能会与超过 Windows 最大路径限制的文件路径进行交互。

解决方案：若要解决此问题，必须启用新的长路径行为。若要执行该操作，请参阅 Microsoft Windows 应用程序开发文档中的在 Windows 10 版本 1607 及更高版本中启用长路径。

错误：pip 的依赖项解析程序...

错误文本示例：

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. 
aws-sam-cli 1.58.0 requires aws-sam-translator==1.51.0, but you have aws-sam-translator 1.58.0 which is incompatible. 
aws-sam-cli 1.58.0 requires typing-extensions==3.10.0.0, but you have typing-extensions 4.4.0 which is incompatible.

错误：没有‘remote’这样的命令

运行 sam remote invoke 命令时，您遇到以下错误：

$ sam remote invoke ...
2023-06-20 08:15:07 Command remote not available
Usage: sam [OPTIONS] COMMAND [ARGS]...
Try 'sam -h' for help.

Error: No such command 'remote'.

错误：在本地运行 Amazon SAM 项目需要 Docker。 你安装好了吗？

运行 sam local start-api 命令时，您遇到以下错误：

Error: Running Amazon SAM projects locally requires Docker. Have you got it installed?

这意味着你没有 Docker 已正确安装。Docker 需要在本地测试您的应用程序。要解决此问题，请按照有关在开发主机上安装 Docker 的说明操作。有关更多信息，请参阅 安装 Docker。

错误：未满足安全限制

运行 sam deploy --guided 时，系统用问题 Function may not have authorization defined, Is this okay? [y/N] 向您发出提示。如果您用 N（默认选项）来回应此提示，将会出现以下错误：

Error: Security Constraints Not Satisfied

此提示告知您，您即将部署的应用程序可能在未经授权的情况下配置了可公开访问的 Amazon API Gateway API。用 N 来回应此提示，即表明您不同意继续部署。

要解决此问题，您具有以下选项：

消息：身份验证令牌缺失

尝试调用 API Gateway 端点时，您遇到以下错误：

{"message":"Missing Authentication Token"}

这意味着您向正确的域发送了请求，但系统无法识别 URI。要解决此问题，请验证完整的 URL，然后使用正确的 URL 更新 curl 命令。

警告消息

警告：... Amazon 将不再维护 Homebrew 适用于 Amazon SAM ... 的安装程序

安装时 Amazon SAM CLI 使用 Homebrew，您会看到以下警告消息：

Warning: ... Amazon will no longer maintain the Homebrew installer for Amazon SAM (aws/tap/aws-sam-cli). 
				For AWS supported installations, use the first party installers ...