Hasura Flutter中如何通过任务category_id关联查询分类名称？

核心问题原因 #

你之前尝试将tasks['category_id']直接作为category_by_pk的参数，这种写法不符合GraphQL查询规范——在查询tasks集合/单条数据时，不能同时将当前数据的字段作为另一个查询的参数嵌套调用。正确的做法是利用Hasura基于外键自动生成的关联关系字段，或者单独传入参数执行分类查询。

方案1：使用关联嵌套查询（推荐） #

Hasura会自动识别tasks.category_id与categories.id的外键关联，并为tasks表生成关联字段（默认名为category），通过这个字段可以直接嵌套查询分类信息，一次请求完成数据获取，效率更高。

Hasura GraphQL查询语句 #

# 查询所有任务及对应分类信息
query GetTasksWithCategory {
  tasks {
    id
    task_name
    category_id
    status
    # 嵌套查询关联的分类数据
    category {
      category_name
      color # 按需获取其他分类字段
    }
  }
}

# 查询单个任务及对应分类名称
query GetSingleTaskWithCategory($taskId: Int!) {
  tasks_by_pk(id: $taskId) {
    id
    task_name
    status
    category {
      category_name
    }
  }
}

Flutter中执行查询（基于graphql_flutter包） #

// 定义查询常量
const String getTasksWithCategoryQuery = r'''
query GetTasksWithCategory {
  tasks {
    id
    task_name
    category_id
    status
    category {
      category_name
      color
    }
  }
}
''';

// 执行查询并处理结果
Future<void> fetchTasksWithCategory(BuildContext context) async {
  final graphQLClient = GraphQLProvider.of(context).value;
  final result = await graphQLClient.query(
    QueryOptions(document: gql(getTasksWithCategoryQuery)),
  );

  if (result.hasException) {
    print('查询错误：${result.exception.toString()}');
    return;
  }

  final List<dynamic> tasks = result.data?['tasks'] ?? [];
  for (final task in tasks) {
    final taskName = task['task_name'];
    // 兼容分类不存在的情况
    final categoryName = task['category']?['category_name'] ?? '未分类';
    print('任务：$taskName | 分类：$categoryName');
  }
}

方案2：单独根据category_id查询分类名称 #

如果已经获取了任务的category_id，需要单独查询分类名称，要确保传入的参数类型与Hasura中categories.id的类型一致（比如Int/uuid），并通过变量传递参数。

Hasura GraphQL查询语句 #

query GetCategoryName($categoryId: Int!) {
  categories_by_pk(id: $categoryId) {
    category_name
  }
}

Flutter中执行查询 #

const String getCategoryNameQuery = r'''
query GetCategoryName($categoryId: Int!) {
  categories_by_pk(id: $categoryId) {
    category_name
  }
}
''';

// 假设已获取任务的category_id
Future<String?> fetchCategoryName(BuildContext context, int categoryId) async {
  final graphQLClient = GraphQLProvider.of(context).value;
  final result = await graphQLClient.query(
    QueryOptions(
      document: gql(getCategoryNameQuery),
      variables: {'categoryId': categoryId},
    ),
  );

  if (result.hasException) {
    print('查询错误：${result.exception.toString()}');
    return null;
  }

  return result.data?['categories_by_pk']?['category_name'] ?? '未分类';
}

常见错误排查 #

1. 参数类型不匹配：检查category_id的类型（比如是整数还是UUID），确保查询变量的类型与Hasura表定义一致
2. 关联关系未生成：如果Hasura没有自动生成category关联字段，需要在Hasura控制台的「数据」->「关系」页面手动创建外键关联

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