Flutter Sqflite：如何处理Bad State: no Element异常？

我开发了一个带用户注册登录功能的Flutter应用，当使用数据库中不存在的用户名登录时，想要显示“无此用户”类的提示。尝试处理Bad State: no Element异常但无法捕获，修改后的try-catch代码也没有效果，而且IDE不建议直接使用Exception关键字。目前临时通过fetchAll函数配合for循环检查用户存在性，但希望通过查询语句直接解决问题。

原始代码 #

最初的查询函数：

Future<Users> fetchByUsername(String nomeUtente) async {
      final database = await DatabaseService("users.db").database;
      final users = await database.rawQuery('''SELECT * from $tableName WHERE nomeUtente = ?''', [nomeUtente]);
      return Users.fromSqfliteDatabase(users.first);
}

修改后的无效代码：

Future<Users?> fetchByUsername(String nomeUtente) async {
   final database = await DatabaseService("users.db").database;
   try {
     final users = await database.rawQuery('''SELECT * from $tableName WHERE nomeUtente = ?''', [nomeUtente]);
     return Users.fromSqfliteDatabase(users.first);
  } on Exception catch (e) {
  return null;
  }
}

Users类定义 #

class Users {
  final String nomeUtente;
  final String email;
  final String password;
  final String dataNascita;

  Users({
    required this.nomeUtente,
    required this.email,
    required this.password,
    required this.dataNascita,
  });

  factory Users.fromSqfliteDatabase(Map<String, dynamic> map) => Users (
    nomeUtente: map['nomeUtente']?.toString() ?? '',
    email: map['email']?.toString() ?? '',
    password: map['password']?.toString() ?? '',
    dataNascita: map['dataNascita']?.toString() ?? '',
  );
}

问题原因 #

users.first在查询结果为空列表时抛出的是**StateError**，它属于Error类型而非Exception类型，因此用on Exception catch无法捕获该错误。

解决方案 #

方案1：提前判断列表是否为空（推荐） #

直接检查查询返回的用户列表长度，避免触发异常，代码更简洁直观：

Future<Users?> fetchByUsername(String nomeUtente) async {
  final database = await DatabaseService("users.db").database;
  final users = await database.rawQuery('''SELECT * from $tableName WHERE nomeUtente = ?''', [nomeUtente]);
  
  // 无匹配用户时返回null或自定义虚拟用户
  if (users.isEmpty) {
    return null;
    // 或者返回虚拟用户：
    // return Users(nomeUtente: '', email: '', password: '', dataNascita: '');
  }
  
  return Users.fromSqfliteDatabase(users.first);
}

方案2：捕获具体的StateError #

如果坚持使用异常捕获方式，需要明确捕获StateError：

Future<Users?> fetchByUsername(String nomeUtente) async {
  final database = await DatabaseService("users.db").database;
  try {
    final users = await database.rawQuery('''SELECT * from $tableName WHERE nomeUtente = ?''', [nomeUtente]);
    return Users.fromSqfliteDatabase(users.first);
  } on StateError catch (_) {
    // 捕获列表为空时的Bad State错误
    return null; // 或虚拟用户
  }
}

后续使用逻辑 #

在登录页面调用fetchByUsername后，根据返回值处理提示：

void handleLogin(String username) async {
  final user = await fetchByUsername(username);
  if (user == null) {
    // 显示“无此用户”提示
    print("无此用户");
  } else {
    // 继续验证密码等后续流程
    verifyPassword(user.password, inputPassword);
  }
}

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