如何为AWS Amplify Gen 2应用关联自定义域名？（选项已禁用）

API 探路者

2026-6-30

解决AWS Amplify Gen2自定义域名选项禁用的步骤

确认应用已完成初始部署
Amplify Gen2要求应用先完成至少一次成功部署，自定义域名选项才会激活。如果尚未部署，在项目根目录执行部署命令：
```
npx amplify deploy
```
等待部署完成后刷新控制台，查看选项是否解锁。
检查当前选中的环境状态
自定义域名仅支持绑定到已部署的环境，确保在Amplify控制台中选中的是已完成部署的环境（而非未初始化的空环境）。
验证IAM权限
确保操作账户拥有以下核心权限：
- amplify:UpdateDomainAssociation
- route53:ListHostedZones
- route53:ChangeResourceRecordSets
  如果使用的是受限IAM角色，需要补充对应权限策略。
通过CLI手动配置（控制台仍不可用时）
若控制台选项仍无法激活，可直接通过Amplify CLI完成域名绑定：
1. 进入项目根目录，执行：
```
npx amplify add domain
```
2. 按照交互提示输入你的域名www.example.com，按需配置根域名关联、SSL证书等选项
3. 执行部署命令应用配置：
```
npx amplify deploy
```
4. 根据CLI输出的提示，到你的域名服务商后台配置对应的DNS记录（通常为CNAME或NS记录）
排查域名冲突
确认www.example.com未被其他AWS资源（如其他Amplify应用、CloudFront分发、Route53托管区）绑定，避免因资源占用导致选项禁用。