Flutter中Freezed结合json_serializable使用Map遇序列化错误求助

我之前也碰到过类似的Freezed反序列化Firestore数据的报错，结合你的代码和错误栈来看，大概率是Firestore存储的字段类型和你的User类定义不匹配，或者生成的Freezed代码过时导致的。下面给你一步步的排查和解决方法：

1. 先确认Firestore文档的字段类型完全匹配 #

先去Firebase控制台检查你的User文档每个字段的类型：

• uid：必须是String类型，而且不能为空（因为你加了@required）
• firstName/lastName/email：如果存在的话必须是String，不存在的话没问题（因为是可选参数）
• pictures：如果这个字段存在，必须是String键对应dynamic值的Map（如果你改成<String,String>，那所有值都得是String类型）；如果字段不存在，Freezed会自动设为null，不会报错
• isAdmin：如果存在必须是bool类型；如果不存在，@Default(false)会自动赋值，但如果Firestore里存的是int（比如0/1），就会触发反序列化错误

2. 打印Firestore原始数据，精准定位问题 #

在你的getUserInfo方法里，先把从Firestore拿到的原始数据打印出来，看看实际返回的字段和类型：

// 在User user = User.fromJson(...)之前加这行
print('Firestore原始数据: $dataFromFirebase');

通过打印结果你能直接看到：是不是pictures字段是List而不是Map？是不是isAdmin存的是int？这些都是常见的坑。

3. 处理类型不匹配的字段 #

如果发现类型不匹配，比如isAdmin存的是int（0/1），可以在反序列化前先转换：

// 处理isAdmin的int转bool
if (dataFromFirebase.containsKey('isAdmin')) {
  final dynamic isAdminValue = dataFromFirebase['isAdmin'];
  dataFromFirebase['isAdmin'] = isAdminValue is int 
      ? isAdminValue == 1 
      : isAdminValue;
}

// 如果pictures字段是其他类型，比如List，也可以在这里转换为Map（根据你的业务逻辑）
// if (dataFromFirebase.containsKey('pictures') && dataFromFirebase['pictures'] is List) {
//   dataFromFirebase['pictures'] = ...; // 转换为符合要求的Map
// }

// 再反序列化
User user = User.fromJson(dataFromFirebase);

4. 重新生成Freezed代码 #

有时候修改了类定义后，没有重新运行build_runner，导致生成的代码过时，这也会引发奇怪的错误。运行以下命令重新生成：

flutter pub run build_runner build --delete-conflicting-outputs

确保freezed_classes.g.dart和freezed_classes.freezed.dart是最新的。

5. 自定义Freezed的fromJson逻辑（可选） #

如果需要更灵活的处理，可以直接在User类里自定义fromJson方法，把转换逻辑封装进去：

@freezed
abstract class User with _$User {
  factory User({
    @required String uid,
    String firstName,
    String lastName,
    String email,
    Map<String, dynamic> pictures,
    @Default(false) bool isAdmin,
  }) = _User;

  factory User.fromJson(Map<String, dynamic> json) {
    // 在这里统一处理类型转换
    if (json.containsKey('isAdmin') && json['isAdmin'] is int) {
      json['isAdmin'] = (json['isAdmin'] as int) == 1;
    }
    // 其他字段的转换逻辑也可以加在这里
    return _$UserFromJson(json);
  }
}

按照上面的步骤排查，基本能解决你遇到的反序列化错误。

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