升级Amplify CLI后backend-config.json不存在的问题如何解决？

报错场景 #

升级Amplify CLI后项目的amplify/backend/backend-config.json文件丢失，执行amplify init选择已有/新建环境均返回路径不存在错误。

解决步骤 #

方案一：云端拉取配置（推荐，适用于已同步后端到Amplify云端的场景） #

• 提前备份本地现有amplify文件夹到其他路径，避免配置丢失
• 执行拉取命令，直接从云端同步完整后端配置：
  amplify pull --appId <你的应用ID> --envName <你的目标环境名>
  • 应用ID可在AWS控制台的Amplify服务对应应用的设置页查询
  • 环境名替换为你之前使用的环境标识，如dev、prod
• 命令执行完成后会自动生成缺失的backend-config.json文件，无需走本地init的前置校验逻辑

方案二：本地手动生成基础配置（适用于未同步到云端的本地项目） #

• 进入amplify/backend/目录，手动新建空白backend-config.json文件
• 写入最小可用基础配置：

{
  "version": 1,
  "frontend": "你的项目前端类型，如javascript、flutter等",
  "backend": {}
}

• 重新执行amplify init选择对应环境，CLI会自动补全配置文件内的剩余内容，不会再报文件不存在错误

方案三：清理缓存修复兼容问题 #

如果上述操作后仍报错，大概率是CLI版本兼容或本地缓存异常导致：

• 执行amplify clean清理本地临时缓存文件
• 重新安装对应版本Amplify CLI：npm install -g @aws-amplify/cli
• 重新执行amplify pull或amplify init操作

注意：如果本地存在未同步到云端的后端自定义修改，操作前务必完整备份amplify目录，避免云端配置覆盖本地修改。

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