GitHub Action部署NextJS到AWS S3报凭证无效/桶名已占用问题咨询

a) 报错解决方法 #

该报错明确指向两种故障原因，按优先级排查即可：

• 确认S3桶名全局唯一性：S3桶名是全球所有AWS用户共用的命名空间，不存在仅属于你的「全新名称」，你可以先登录AWS控制台手动尝试创建对应名称的桶，若提示名称已被占用，直接更换为带唯一标识的名称即可，比如增加团队标识、项目前缀等，示例：corp-marketing-site-dev-2024。
• 若手动创建桶成功，说明是凭证权限问题：
  • 检查GitHub Action中配置的AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY对应的IAM用户权限，至少要开放s3:CreateBucket、s3:PutBucket*、s3:GetBucket*、s3:ListBucket，以及cloudfront:*、lambda:*等@sls-next/serverless-component所需的资源权限。
  • 确认IAM用户没有区域访问限制，和你serverless.yaml中配置的部署区域匹配。
  • 检查serverless.yaml的分支环境判断逻辑，确认不同分支读取的桶名配置没有拼写错误、没有串用其他环境的桶名。

b) 多环境部署逻辑可行性 #

你的部署逻辑是可行的，落地时注意以下细节即可：

• 确认你使用的@sls-next/serverless-component版本适配Next.js 14/15，尤其是如果你使用了App Router，需要升级到组件的最新稳定版本，否则会出现构建失败问题。
• 建议在serverless.yaml中通过stage参数动态匹配不同环境的配置，不用硬编码三个桶名，减少配置错误概率。
• 要实现CloudFront地址固定，需要保留每次部署的状态文件：建议将.serverless目录下的状态文件托管到独立的S3状态桶，或者使用Serverless Framework官方的状态托管服务，只要不手动删除已创建的CloudFront分配，后续部署不会变更访问地址。
• 建议给生产环境的GitHub Action触发规则增加人工审核步骤，避免误操作推送代码直接更新生产环境。

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