AWS Amplify Gen1 GraphQL代码生成报错：未知类型AWSModelQueryMap

开发者阿泽

2026-6-16

解决方案：Amplify Gen1代码生成报错「AWSModelQueryMap未知」

针对你遇到的Amplify push后代码生成失败、提示Invalid or incomplete schema, unknown type: AWSModelQueryMap的问题，可尝试以下几种解决步骤：

清理本地代码生成缓存
删除项目中amplify/generated目录，同时清理Node缓存：
```
rm -rf amplify/generated
rm -rf node_modules/.cache
```
之后重新执行代码生成命令：
```
amplify codegen
```
或者重新推送项目：
```
amplify push
```
降级Amplify CLI至稳定版本
你当前使用的CLI 12.13.0可能存在已知兼容性bug，尝试降级到12.12.0版本：
```
npm install -g @aws-amplify/cli@12.12.0
```
降级后重新执行amplify push。
强制生成完整introspection schema
手动触发完整的introspection查询来生成客户端schema：
```
amplify codegen --generate-introspection
```
执行完成后再重新推送项目。
切换Node.js版本至LTS兼容版
Node.js 20.x与Amplify CLI 12.x可能存在兼容性冲突，临时切换到Node.js 18 LTS版本（可通过nvm快速切换）：
```
nvm use 18
```
切换后重新执行amplify push。
重新初始化API模块
如果以上方法都无效，删除现有API模块后重新创建：
```
amplify remove api
amplify add api
```
选择默认的待办事项列表Schema，完成配置后再执行amplify push。