Flutter SQLite报错：Null类型无法转换为String类型求助

问题根源 #

报错type 'Null' is not a subtype of type 'String'的核心原因是：

• 你的StudentsModel要求studentName和studentEmail必须是非空字符串，但数据库中存在至少一条记录的student_name或student_email字段值为NULL。
• 搜索功能正常是因为搜索条件过滤掉了这些含NULL值的记录，而全量加载时会读取所有数据，触发类型转换错误。

另外还有一个潜在风险：HomepageCubit中emit(allStudentsList!);的强制解包，如果getAllStudents返回null，会直接崩溃。

解决方案 #

1. 定位具体问题字段 #

在仓库层的getAllStudents方法中添加打印，输出每条数据库记录，快速定位含NULL值的字段：

Future<List<StudentsModel>?> getAllStudents() async {
    var db = await DatabaseCopy.databaseAccess();
    List<Map<String, dynamic>> listOfStudents = await db.rawQuery("SELECT * FROM students");
    return List.generate(listOfStudents.length, (index) {
      var row = listOfStudents[index];
      print("第${index+1}条记录: $row"); // 打印每条数据，查看null字段
      return StudentsModel(
        studentId: row["student_id"],
        studentName: row["student_name"],
        studentEmail: row["student_email"],
      );
    });
  }

2. 处理NULL值（二选一即可） #

方案A：SQL查询时设置默认值

使用SQL的COALESCE函数，将NULL替换为空字符串，确保返回的字段都是非空字符串：

List<Map<String, dynamic>> listOfStudents = await db.rawQuery(
  "SELECT student_id, COALESCE(student_name, '') AS student_name, COALESCE(student_email, '') AS student_email FROM students"
);

方案B：修改模型类兼容NULL值

如果允许字段为空，可将模型类的字段改为可空类型，或者在构造时自动替换NULL为默认值：

// 方式1：字段设为可空类型（需在UI层处理空值展示）
class StudentsModel {
  final int studentId;
  final String? studentName;
  final String? studentEmail;

  StudentsModel({
    required this.studentId,
    this.studentName,
    this.studentEmail,
  });
}

// 方式2：构造时自动将NULL转为空字符串，保持字段非空
class StudentsModel {
  final int studentId;
  final String studentName;
  final String studentEmail;

  StudentsModel({
    required this.studentId,
    String? studentName,
    String? studentEmail,
  })  : studentName = studentName ?? '',
        studentEmail = studentEmail ?? '';
}

3. 修复Cubit强制解包风险 #

避免allStudentsList为null时触发崩溃，修改loadAllStudents方法：

Future<void> loadAllStudents() async {
  final allStudentsList = await sRepo.getAllStudents();
  emit(allStudentsList ?? []); // 若返回null则发射空列表
}

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