Flutter执行amplify pull后数据模型未更新的解决方法咨询

架构老林

2026-7-11

解决Flutter中AWS Amplify Pull后新GraphQL模型未同步的问题

以下是针对性的解决步骤，按优先级尝试：

确认云端schema已完成部署
登录AWS AppSync控制台，找到目标API，检查其schema是否包含新增的模型，同时确认最近有成功的部署记录。如果控制台的schema已更新但未部署，先完成部署操作。
清除本地缓存并重新拉取
本地缓存可能导致拉取到旧数据，执行以下命令：
```
amplify cache clear
amplify pull
```
执行amplify pull时若需选择，确保选中正确的AppID和环境。
手动触发模型代码生成
若amplify pull更新了schema但未自动生成新模型代码，手动运行代码生成命令：
```
amplify codegen models
```
该命令会基于更新后的schema.graphql重新生成lib/models目录下的所有Dart模型类，包括新增模型。
检查并更新Amplify CLI版本
旧版本CLI可能存在同步bug，先查看当前版本：
```
amplify --version
```
若不是最新版，用npm更新：
```
npm install -g @aws-amplify/cli
```
验证本地配置并重新生成模型
打开amplify/backend/api/<你的API名称>/schema.graphql，确认新增模型已存在。如果存在但lib/models中无对应文件，删除整个lib/models目录，再重新运行amplify codegen models。
重置本地API配置（最后方案）
若以上步骤均无效，尝试移除本地API配置后重新拉取：
```
amplify remove api
amplify pull
```
注意：此操作仅删除本地API配置文件，不会影响云端数据库和schema。