首次搭建AWS Amplify(Gen2)项目遇错误：无法解析@/amplifyconfiguration.json

开发者阿泽

2026-6-27

解决AWS Amplify (Gen2)项目中@/amplifyconfiguration.json找不到的问题

先确认配置文件是否生成
执行amplify push或amplify build，Amplify Gen2会在项目根目录生成amplify_outputs.json——这是Gen2的默认配置文件，传统的amplifyconfiguration.json是Gen1的产物。如果你的代码里直接用了Gen1的路径引用，要么改成读取amplify_outputs.json，要么确认是否需要手动生成旧格式的配置文件。
检查路径别名的配置
项目里的@别名一般在tsconfig.json或jsconfig.json中设置，看看baseUrl和paths是不是指向了src目录，比如：
```
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"]
    }
  }
}
```
要是amplifyconfiguration.json在项目根目录，@/会直接指向src/，自然找不到。这时候要么把引用路径改成../amplifyconfiguration.json，要么调整别名配置让它包含根目录。
手动拉取配置文件（如果必须用旧格式）
如果你确实需要amplifyconfiguration.json，可以执行amplify pull命令拉取云端配置，这个命令会把文件生成到项目根目录。拉取前要确保本地项目已经关联了AWS控制台的Amplify应用，且云端环境已部署。
确认Amplify初始化状态
检查项目是否通过amplify init完成了初始化，且云端资源已正确部署。初始化不完整的话，配置文件不会生成。可以用amplify status查看当前项目状态，确认所有资源都已部署到位。
更新Amplify相关依赖
确保aws-amplify和@aws-amplify/ui-react等依赖是最新版本，Gen2对依赖版本有要求，旧版本可能不兼容新的配置结构。执行npm update aws-amplify @aws-amplify/ui-react更新依赖。