Amplify初始化/添加环境时AuthRole名称重复导致创建失败

一、先解决env.ts变量不更新的缓存问题 #

• 清理Amplify本地缓存：删除项目根目录下的.amplify文件夹，或者执行命令：

  amplify env pull --restore
  

• 确认override.ts中正确导入env.ts变量，导入路径不能出错：

  import { isCrossAccount, ENV_NAME, PRE_FIX, POST_FIX, ACCOUNT_ID } from './env';
  

• 切换到目标新环境再执行后续操作：

  amplify env checkout <你的新环境名称>
  

二、确保AuthRole名称同账号唯一 #

• 优先使用Amplify内置环境变量替代自定义env.ts的ENV_NAME，避免缓存问题，修改override.ts：

  import { AmplifyRootStackTemplate } from '@aws-amplify/cli-extensibility-helper';
  
  export function override(resources: AmplifyRootStackTemplate) {
    // 直接用Amplify内置的环境变量，无需依赖env.ts
    const envName = process.env.ENV || 'default-env';
    const preFix = 'your-custom-prefix'; // 可替换为process.env.PRE_FIX从系统环境变量读取
  
    const authRole = resources.authRole;
    // 生成带环境名的唯一角色名
    authRole.roleName = `${preFix}-amplify-authrole-${envName}`;
  
    if (process.env.IS_CROSS_ACCOUNT === 'true') {
      const basePolicies = Array.isArray(authRole.policies)
        ? authRole.policies
        : [authRole.policies];
      authRole.policies = [
        ...basePolicies,
        {
          policyName: `${preFix}-amplify-authrole-assumerole-policy`,
          policyDocument: {
            Version: "2012-10-17",
            Statement: [
              {
                Action: "sts:AssumeRole",
                Resource: `arn:aws:iam::${process.env.ACCOUNT_ID}:role/${preFix}-xxx-${process.env.POST_FIX}`,
                Effect: "Allow",
              },
            ],
          },
        },
      ];
    }
  }
  

• 执行amplify add env时指定唯一的环境名称，比如：

  amplify add env --name staging-v2
  

三、处理已存在的AuthRole #

• 如果旧AuthRole已废弃，直接在IAM控制台搜索角色名删除（需确认无关联资源在使用）。
• 如果旧AuthRole仍在使用，必须保证新环境的角色名完全不重复，通过override.ts的配置强制生成唯一名称。

验证步骤 #

1. 清理本地缓存后切换到新环境。
2. 执行amplify push，查看CloudFormation事件，确认AuthRole的名称是带新环境名的唯一值。

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