在Floor实体中使用TypeConverter处理非默认类型时出错

问题原因 #

你的AgroDataConverter泛型声明为TypeConverter<AgroData, String>，但实体类Parcel中的agroData是可空类型AgroData?，Floor的类型转换器默认不会自动处理可空包装，导致代码生成时无法识别该字段类型。另外需确认是否导入了dart:convert库（jsonEncode/jsonDecode依赖该库），缺失会引发隐性转换问题。

修复步骤 #

1. 修改转换器适配可空类型 #

将转换器泛型改为TypeConverter<AgroData?, String?>，同时处理null值场景：

import 'dart:convert';
import 'package:floor/floor.dart';
import 'AgroData.dart';

class AgroDataConverter extends TypeConverter<AgroData?, String?> {
  @override
  AgroData? decode(String? databaseValue) {
    if (databaseValue == null) return null;
    return AgroData.fromJson(jsonDecode(databaseValue) as Map<String, dynamic>);
  }

  @override
  String? encode(AgroData? value) {
    if (value == null) return null;
    return jsonEncode(value.toJson());
  }
}

2. 确保转换器正确关联 #

可选择在字段或实体类层级添加注解，推荐字段层级更精准：

@Entity(primaryKeys: ['localId'])
@JsonSerializable()
class Parcel extends CustomEntity {
  // ...
  @TypeConverters([AgroDataConverter])
  final AgroData? agroData;
  // ...
}

3. 清理缓存并重新生成代码 #

执行命令清除旧生成文件，避免缓存干扰：

dart run build_runner clean
dart run build_runner build --delete-conflicting-outputs

额外检查点 #

• 确认AgroData类的toJson()和fromJson()方法已通过json_serializable正常生成（part 'AgroData.g.dart';配置无误）
• 确保Floor与json_serializable使用最新稳定版本，避免版本兼容问题

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