Flutter中如何从Firestore直接获取字段值为String变量

你可以通过独立异步函数直接获取Firestore字段值并赋值给String变量，无需依赖FutureBuilder这类Widget组件，具体实现步骤如下：

1. 在页面State类中定义状态变量 #

在_ScreenAState里添加需要存储的字段变量，以及加载状态标记：

class _ScreenAState extends State<ScreenA> {
  String? _userFirstName; // 存储目标字段值
  bool _isLoading = true; // 标记数据加载状态

  // ... 原有代码
}

2. 编写异步函数获取Firestore数据 #

替换原来的getDocId函数，直接在异步请求中提取目标字段，无需先单独获取文档ID再二次请求：

Future<void> fetchUserData() async {
  try {
    final userId = AuthService.firebase().currentUser!.id;
    // 直接查询符合条件的用户文档
    final querySnapshot = await FirebaseFirestore.instance
        .collection('user')
        .where('user_id', isEqualTo: userId)
        .get();

    if (querySnapshot.docs.isNotEmpty) {
      // 假设每个user_id对应唯一文档，取第一个结果
      final userData = querySnapshot.docs.first.data() as Map<String, dynamic>;
      setState(() {
        _userFirstName = userData['first_name'] as String; // 赋值给String变量
        _isLoading = false;
      });
    } else {
      setState(() {
        _isLoading = false;
        print('未找到对应用户的文档');
      });
    }
  } catch (e) {
    setState(() {
      _isLoading = false;
      print('获取数据失败: $e');
    });
  }
}

3. 在生命周期中触发数据请求 #

在页面初始化时调用异步函数，开始获取数据：

@override
void initState() {
  super.initState();
  fetchUserData(); // 页面加载时触发数据请求
}

4. 根据状态变量渲染UI #

现在可以直接使用_userFirstName变量，无需依赖Gettt组件：

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: _isLoading
        ? const Center(child: CircularProgressIndicator()) // 加载中状态
        : _userFirstName != null
            ? Center(child: Text('用户名字: $_userFirstName')) // 展示获取到的字段值
            : const Center(child: Text('未获取到用户信息')), // 无数据状态
  );
}

拓展：获取多个文档的字段值 #

如果需要获取多个文档的first_name，可以把变量改成列表：

List<String> _firstNames = [];

// 修改fetchUserData中的处理逻辑
if (querySnapshot.docs.isNotEmpty) {
  setState(() {
    _firstNames = querySnapshot.docs
        .map((doc) => doc.data()['first_name'] as String)
        .toList();
    _isLoading = false;
  });
}

这样就能直接拿到存储字段值的变量，完全脱离Widget组件的依赖。

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