Flutter中使用SQFlite读取单条记录及Future与Null处理问题

问题场景 #

你在使用sqflite查询组织记录时，定义了返回Future<Organisation?>的readOrganisationById方法，但调用时直接操作Future对象导致报错：The getter 'name' isn't defined for the type 'Future<Organisation?>'。

错误原因 #

readOrganisationById返回的是Future对象，它代表异步操作的"未来结果"，而非直接的Organisation?实例。你不能直接访问Future对象的name属性，必须先等待异步操作完成，获取到实际结果后再处理。

正确调用方式 #

方式1：使用async/await（推荐，代码简洁易读）

在包含调用代码的函数前添加async关键字，用await等待Future完成，再对结果做null检查：

// 确保当前函数标记为async
void handleOrganisation(int organisationId) async {
  Organisation? org = await readOrganisationById(organisationId);
  if (org != null) {
    String organisationName = org.name;
    // 后续业务逻辑
  } else {
    // 未找到组织的处理逻辑
  }
}

方式2：使用Future.then()

如果无法使用async/await（比如在非异步函数中），可以用then方法处理异步结果：

readOrganisationById(organisationId).then((Organisation? org) {
  if (org != null) {
    String organisationName = org.name;
    // 后续业务逻辑
  } else {
    // 未找到组织的处理逻辑
  }
});

额外提示 #

你的Organisation类的toMap方法中，键名'organisation'和查询语句中的字段id不匹配，建议修正为与数据库字段一致的名称，避免后续写入数据时出错：

Map<String, dynamic> toMap() {
  return {
    'id': organisationId, // 改为和查询语句中的字段名一致
    'name': name,
  };
}

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