Supabase一对多关系数据拉取优化方案咨询

你当前的实现存在N+1查询问题：先拉取所有分类，再循环每个分类单独请求子分类，当分类数量较多时，会产生大量请求，拖慢接口性能。下面是基于Supabase嵌套查询的优化方案，一次请求就能拉取所有分类及其关联的子分类。

优化后的代码实现 #

@override
Future<Either<Exception, List<CategoryModel>>> watchAll() async {
  final ISentrySpan transaction = Sentry.startTransaction(
    this.runtimeType.toString(), 
    CustomLoggerStackTrace.getCurrentStackTraceInfo(StackTrace.current)
  );
  transaction.status = const SpanStatus.ok();
  
  try {
    // 核心优化：使用嵌套查询，一次性拉取分类及其关联的子分类
    final List<Map<String, dynamic>> response = await _supabase.client
        .from(_categorySupabaseTable.tableName)
        .select('*, ${_subcategorySupabaseTable.tableName}(*)') // 替换成你的子分类表名
        .order(_categorySupabaseTable.idColumn, ascending: true);

    // 直接从返回结果中解析分类和对应的子分类，无需循环请求
    final List<CategoryModel> completedCategoryModels = response.map((categoryMap) {
      // 提取子分类数据并转换为SubcategoryModel列表
      final List<Map<String, dynamic>> subcategoryMaps = 
          List.from(categoryMap[_subcategorySupabaseTable.tableName] ?? []);
      final List<SubcategoryModel> subcategories = subcategoryMaps
          .map((subMap) => SubcategoryModel.fromJson(subMap))
          .toList();

      // 移除子分类字段，避免干扰CategoryModel的解析
      final cleanedCategoryMap = Map<String, dynamic>.from(categoryMap)
        ..remove(_subcategorySupabaseTable.tableName);

      return CategoryModel.fromJson(cleanedCategoryMap).copyWith(subcategories: subcategories);
    }).toList();

    return right(completedCategoryModels);
  } on PostgrestException catch (exception) {
    log.e(exception);
    transaction.throwable = exception;
    transaction.status = const SpanStatus.internalError();
    return left(exception);
  } on Exception catch (exception) {
    log.e(exception);
    transaction.throwable = exception;
    transaction.status = const SpanStatus.internalError();
    return left(exception);
  } finally {
    await transaction.finish();
  }
}

关键说明 #

1. 嵌套查询语法：select('*, subcategories(*)') 中的subcategories是你的子分类表名，Supabase会自动根据表间的外键关系（比如subcategories表的category_id字段关联categories表的id）返回嵌套的子分类数组。
2. 外键约束注意：如果你的外键不是默认命名，可能需要显式指定约束名，比如：

   .select('*, subcategories!categories_subcategories_fkey(*)')
   

   这里的categories_subcategories_fkey是你在Supabase控制台中创建的外键约束名称。
3. 模型解析优化：从返回的分类Map中提取子分类数据，转换为SubcategoryModel列表后，需要移除子分类字段再解析CategoryModel，避免字段冲突。

性能对比 #

• 原方案：1次分类查询 + N次子分类查询（N为分类数量）
• 优化后：仅1次查询，大幅减少网络请求开销，提升接口响应速度

内容的提问来源于stack exchange，提问作者Jan Cahlík