Firestore事务Future异常求助：始终触发最终返回语句

你的核心问题是没有正确等待Firestore事务的异步结果，混用async/await和.then导致代码逻辑未按预期阻塞等待，函数直接执行到末尾的默认返回语句。

问题拆解 #

1. runTransaction返回Future，但你既没使用await等待它完成，也没将这个Future作为函数返回值，导致函数跳过事务异步逻辑，直接执行最后的默认返回。
2. 事务内部的返回值（如'Username is already assigned'）未正确传递到外层，.then里的返回值也没被外层捕获。
3. 异常处理覆盖不全，事务内部的错误可能无法被正确捕获。

修正后的代码 #

Future<String> obtainUniqueUsername(
  String requestedUsername,
  String currentUserID,
) async {
  final userName = requestedUsername.toLowerCase();
  final userRef = FirebaseFirestore.instance.doc('usernames/$userName');

  try {
    // 用await等待事务完成，获取返回结果
    final result = await FirebaseFirestore.instance.runTransaction((transaction) async {
      final userSnapshot = await transaction.get(userRef);

      if (userSnapshot.exists) {
        return 'Username is already assigned';
      } else {
        await transaction.set(userRef, {'uid': currentUserID});
        return 'Username assigned';
      }
    });
    return result;
  } catch (e) {
    return 'Transaction error ${e.toString()}';
  }
}

关键修正点 #

• 弃用.then，全程用async/await，确保代码按顺序执行，等待事务完成后再返回结果。
• 事务内部统一返回明确结果：无论用户名是否存在，都通过return把结果传递到外层。
• 外层直接返回事务的await结果，避免函数提前走到默认返回语句。
• 简化冗余变量，直接使用传入的currentUserID参数。

补充说明 #

Firestore事务确实会自动重试直到成功或超时（默认60秒），但前提是你要正确等待它的异步结果。如果不使用await，函数会误认为事务已完成，直接执行后续代码，这就是你遇到问题的根本原因。

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