Amazon API Gateway URL Shortener 项目常见问题解决方案

Amazon API Gateway URL Shortener 项目常见问题解决方案

项目基础介绍

Amazon API Gateway URL Shortener 是一个基于 AWS 的无服务器 URL 缩短器项目。该项目利用 Amazon API Gateway 来处理所有业务逻辑，而无需使用 AWS Lambda 或其他计算服务。主要的后端服务包括 Amazon API Gateway、Amazon Cognito、Amazon DynamoDB 和 AWS Amplify Console。前端则使用 Vue.js 作为演示客户端。

该项目的主要编程语言是 YAML 和 JavaScript。YAML 用于定义 AWS 资源和配置，而 JavaScript 主要用于前端 Vue.js 应用的开发。

新手使用项目时的注意事项及解决方案

1. 部署时遇到 CloudFront 分发创建时间过长

问题描述：
在部署过程中，由于项目中包含了 Amazon CloudFront 分发，创建时间可能会长达 30 分钟。新手可能会误以为部署过程卡住或失败。

解决步骤：

• 步骤 1：耐心等待
  由于 CloudFront 分发的创建需要较长时间，建议用户耐心等待，不要中断部署过程。
• 步骤 2：检查部署状态
  使用 AWS SAM CLI 的部署命令（如 sam deploy -g），并查看终端中的部署状态。如果部署状态显示正在创建 CloudFront 分发，则可以确认部署仍在进行中。
• 步骤 3：查看 CloudFormation 堆栈
  登录 AWS 管理控制台，查看 CloudFormation 堆栈的状态。如果堆栈状态显示为“CREATE_IN_PROGRESS”，则说明部署仍在进行中。

2. 缺少 GitHub 个人访问令牌

问题描述：
在部署过程中，项目要求提供 GitHub 个人访问令牌。如果新手没有创建或保存该令牌，部署将无法继续。

解决步骤：

• 步骤 1：创建 GitHub 个人访问令牌
  登录 GitHub，进入个人设置中的“Developer settings”，然后选择“Personal access tokens”。点击“Generate new token”，并确保选择 repo 范围。
• 步骤 2：保存令牌
  生成令牌后，将其保存在安全且易于访问的地方，如密码管理器。
• 步骤 3：在部署时输入令牌
  在部署过程中，当系统提示输入 GitHub 个人访问令牌时，将保存的令牌粘贴到终端中。

3. 前端 Vue.js 应用无法正常运行

问题描述：
新手在部署完成后，可能会发现前端的 Vue.js 应用无法正常运行，页面显示错误或空白。

解决步骤：

• 步骤 1：检查 AWS Amplify Console
  登录 AWS 管理控制台，进入 AWS Amplify Console，查看前端应用的构建和部署状态。如果构建失败，查看构建日志以获取详细错误信息。
• 步骤 2：检查 Vue.js 应用配置
  确保 Vue.js 应用的配置文件（如 config.js）中的 API 网关 URL 和 Cognito 配置正确无误。
• 步骤 3：本地测试 Vue.js 应用
  在本地运行 Vue.js 应用，使用 npm run serve 命令启动开发服务器，检查应用是否能够正常运行。如果本地运行正常，则问题可能出在 AWS Amplify 的部署配置上。

通过以上解决方案，新手可以更好地理解和使用 Amazon API Gateway URL Shortener 项目，避免常见的部署和运行问题。