Flutter中使用自定义GraphQL Mutation更新单个Amplify模型字段

核心问题修正 #

先梳理你代码里的几个明显错误：

• 变量名不匹配：updateUserGoal应该是updateUserName
• decodePath值错误：getTodo完全不对，需对应mutation的操作结果键名updateUserData
• mutation文档的操作名称可更规范（可选但便于维护）

修正后的完整代码 #

// 修正后的mutation文档，明确操作名称（可选但利于后续维护）
const graphQLDocument = '''mutation UpdateUserData {
  updateUserData(input: {
    id: "123",
    name: "John"
  }) {
    id
    name
    email
  }
}''';

// 构建正确的GraphQLRequest
final updateUserName = GraphQLRequest<UserData>(
  document: graphQLDocument,
  modelType: UserData.classType,
  decodePath: 'updateUserData', // 对应mutation返回的顶层键名
);

// 执行请求（注意变量名匹配）
final response = await Amplify.API.mutate(request: updateUserName).response;

关键问题解答 #

1. decodePath的作用 #

decodePath用来告诉Amplify：从GraphQL响应的JSON结构里，哪个路径下的内容需要映射到UserData模型。比如你的mutation执行后，响应JSON结构大概是：

{
  "data": {
    "updateUserData": {
      "id": "123",
      "name": "John",
      "email": "john@example.com"
    }
  }
}

这里的updateUserData就是要指定的decodePath，Amplify会从这个节点提取数据，转换成你指定的UserData实例。不传的话，Amplify不知道该解析哪个节点，因此会报错。

2. 是否需要用GraphQLOperation替代GraphQLRequest？ #

不需要。GraphQLRequest是用来定义请求参数（文档、模型类型、decodePath等）的类，而GraphQLOperation是调用Amplify.API.mutate后返回的对象，用于监听请求状态、取消请求等。你只需用GraphQLRequest构建请求，传给mutate方法即可。

3. 单字段更新的可行性 #

你的思路是对的：Amplify默认的DataStore.save确实会更新整个模型，但通过自定义GraphQL mutation，完全可以只更新指定字段——只要你的模型输入类型允许（Amplify生成的模型输入默认都是可选字段，所以只传id和要更新的字段即可）。

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