如何实现Firestore通用单文档读取的泛型函数？

你的核心问题是：Dart泛型中的T只是类型占位符，编译器无法确认所有T类型都包含fromJson方法，因此直接调用T.fromJson会报错。下面提供两种可行的解决方案：

方案一：传入fromJson转换器函数 #

直接将模型的fromJson工厂方法作为参数传入泛型函数，无需修改现有模型结构，灵活性最高。

修改后的泛型函数 #

Future<T?> readObjectCollection<T>(
  String docId, 
  String collectionName, 
  T Function(Map<String, dynamic>) fromJson, // 新增转换器参数
) async {
  T? model;
  try {
    final documentSnapshot = await _db.collection(collectionName).doc(docId).get();
    if (documentSnapshot.exists) {
      model = fromJson(documentSnapshot.data()!);
      Get.i.put<T>(model);
    }
  } catch (e) {
    print(e);
    model = null;
  }
  return model;
}

调用示例 #

// 读取用户数据
final user = await readObjectCollection(
  'user123', 
  'users', 
  ModelUser.fromJson, // 直接传入工厂方法引用
);

// 读取其他模型（如ModelPost）
final post = await readObjectCollection(
  'post456', 
  'posts', 
  ModelPost.fromJson,
);

方案二：定义抽象基类约束泛型 #

如果所有模型都自带fromJson方法，可以定义抽象基类统一约束，让编译器识别该方法。

1. 定义抽象基类 #

abstract class BaseModel {
  factory BaseModel.fromJson(Map<String, dynamic> json) => throw UnimplementedError();
}

2. 让模型继承基类 #

class ModelUser extends BaseModel {
  final String id;
  final String name;

  ModelUser({required this.id, required this.name});

  @override
  factory ModelUser.fromJson(Map<String, dynamic> json) {
    return ModelUser(
      id: json['id'],
      name: json['name'],
    );
  }
}

3. 修改泛型函数（添加类型约束） #

Future<T?> readObjectCollection<T extends BaseModel>(
  String docId, 
  String collectionName,
) async {
  T? model;
  try {
    final documentSnapshot = await _db.collection(collectionName).doc(docId).get();
    if (documentSnapshot.exists) {
      // 编译器确认T继承自BaseModel，可调用fromJson
      model = T.fromJson(documentSnapshot.data()!) as T;
      Get.i.put<T>(model);
    }
  } catch (e) {
    print(e);
    model = null;
  }
  return model;
}

调用示例 #

final user = await readObjectCollection<ModelUser>('user123', 'users');
final post = await readObjectCollection<ModelPost>('post456', 'posts');

你之前尝试的问题说明 #

你提到传入工厂函数时出错，大概率是错误地传入了fromJson(json)（带参数的调用），而非函数本身fromJson。正确做法是直接传递函数引用，不需要加括号和参数。

内容的提问来源于stack exchange，提问作者Carlos P.