Next.js 13部署至AWS Amplify失败，寻求解决办法

• 检查CodeCommit与Amplify的权限关联
  确保Amplify服务角色能正常访问CodeCommit仓库：

  • 进入IAM控制台，找到对应Amplify应用的服务角色（命名格式一般是amplify-<app-id>-<env>-role）
  • 给该角色附加AWSCodeCommitReadOnly策略，或者自定义包含codecommit:GetRepository、codecommit:GitPull权限的策略
  • 确认CodeCommit仓库的ACL设置允许这个角色读取仓库内容

• 校准Next.js 13项目的Amplify配置
  Amplify对Next.js 13的App Router有特定配置要求，别漏了：

  • 项目根目录必须有amplify.yml配置文件，参考示例：

    version: 1
    frontend:
      phases:
        preBuild:
          commands:
            - npm install
        build:
          commands:
            - npm run build
      artifacts:
        baseDirectory: .next
        files:
          - '**/*'
      cache:
        paths:
          - node_modules/**/*
    

  • 检查package.json里的build命令是不是next build，别写错
  • 先在本地跑npm run build，确认项目能正常构建，排除代码或依赖问题

• 重置Amplify部署环境
  缓存或环境状态异常是常见诱因：

  • 进入Amplify控制台的对应应用环境
  • 点「部署设置」→「撤销部署」，选最近失败的部署记录撤销
  • 要么手动触发重新部署，要么在构建设置里开「清理缓存」后再部署

• 排查账户与服务限制

  • 去AWS Support中心查服务健康状态，确认Amplify没触发资源配额限制
  • 检查账户有没有未结清的账单，欠费会导致服务功能受限

• 确认区域一致性
  确保CodeCommit仓库和Amplify应用在同一个AWS区域，跨区域访问容易出权限或网络问题

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