求助：无法为AWS Amplify项目添加REST API资源

问题场景 #

已执行以下命令初始化Amplify项目：

amplify configure
amplify init

执行amplify add api时出现差异表现：

• 选择REST API：提示There was an error adding the API resource，执行amplify status确认资源未添加成功
• 选择GraphQL API：弹出相同错误提示，但amplify status显示资源已添加成功

已尝试更新Amplify CLI、多次重新初始化项目，问题仍存在，需成功添加REST API。

排查与解决步骤 #

1. 验证CLI版本兼容性
   先确认当前CLI版本：

   amplify --version
   

   若最新版仍有问题，可尝试降级至稳定版本（例如前一个大版本）：

   npm install -g @aws-amplify/cli@12.10.0
   

2. 获取详细错误日志
   执行添加API命令时带上--debug参数，定位具体报错原因：

   amplify add api --debug
   

   重点关注日志中关于IAM角色创建、API Gateway配置或本地文件写入失败的相关信息。

3. 清理项目残留缓存
   重新初始化后可能存在残留配置，执行以下命令彻底清理：

   amplify clean
   rm -rf .amplify
   rm -rf node_modules
   npm install
   

   清理完成后重新执行amplify init和amplify add api。

4. 检查AWS账户权限
   确认amplify configure使用的IAM用户具备足够权限：

   • 需包含AmazonAPIGatewayAdministrator、AWSLambda_FullAccess、IAMFullAccess（临时排查用，后续可收缩权限）
   • 权限不足会导致REST API的资源链创建失败，而GraphQL可能因部分基础资源已生成，出现状态显示异常的情况。

5. 手动创建REST API配置文件
   若上述方法无效，可手动在amplify/backend/api目录下创建REST API资源：

   • 新建以API名称命名的目录，内部创建parameters.json和template.yaml文件
   • 参照标准Amplify REST API配置模板填充内容，确保参数正确
   • 执行amplify push尝试部署资源

内容的提问来源于stack exchange，提问作者benwl