Flutter新手求助：将Firebase数据读取的StatelessWidget转为Provider函数

我是一名Flutter新手，现有一段从Firebase单次读取数据的StatelessWidget代码，运行正常：

class GetUserName extends StatelessWidget {
  final String documentId;

  GetUserName(this.documentId);

  @override
  Widget build(BuildContext context) {
    CollectionReference users = FirebaseFirestore.instance.collection('users');

    return FutureBuilder<DocumentSnapshot>(
      future: users.doc(documentId).get(),
      builder:
          (BuildContext context, AsyncSnapshot<DocumentSnapshot> snapshot) {

        if (snapshot.hasError) {
          return Text("Something went wrong");
        }

        if (snapshot.hasData && !snapshot.data!.exists) {
          return Text("Document does not exist");
        }

        if (snapshot.connectionState == ConnectionState.done) {
          Map<String, dynamic> data = snapshot.data!.data() as Map<String, dynamic>;
          return Text("Full Name: ${data['full_name']} ${data['last_name']}");
        }

        return Text("loading");
      },
    );
  }
}

我希望将该逻辑移至Provider类中，写成一个函数（替代原GetUserName类），调用该函数时能返回文档的指定字段数据。我此前已通过StreamBuilder实现过流式数据读取，且能通过Map<String, dynamic> data获取data['username']这类字段值。现期望在Provider中编写一个带两个参数的函数，调用方式如Text(myfunction(uid, value))，返回对应uid文档中value字段的字符串值，请问该如何编写此函数并调用？

1. 创建Provider类 #

封装Firebase单次读取逻辑到Provider中：

import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:flutter/foundation.dart';

class UserDataProvider extends ChangeNotifier {
  final FirebaseFirestore _firestore = FirebaseFirestore.instance;

  // 异步函数：接收用户uid和目标字段名，返回字段值或状态提示
  Future<String> getUserField(String uid, String fieldName) async {
    try {
      final docSnapshot = await _firestore.collection('users').doc(uid).get();
      if (!docSnapshot.exists) {
        return "Document does not exist";
      }
      final data = docSnapshot.data() as Map<String, dynamic>;
      if (!data.containsKey(fieldName)) {
        return "Field not found";
      }
      // 统一转为字符串返回，兼容非字符串类型字段
      return data[fieldName].toString();
    } catch (_) {
      return "Something went wrong";
    }
  }
}

2. 注册Provider #

在main.dart中全局注册该Provider：

import 'package:flutter/material.dart';
import 'package:provider/provider.dart';

void main() {
  runApp(
    ChangeNotifierProvider(
      create: (context) => UserDataProvider(),
      child: const MyApp(),
    ),
  );
}

3. 调用函数并渲染数据 #

由于Firebase读取是异步操作，必须结合FutureBuilder处理状态，不能直接在Text中调用异步函数：

// 在需要展示数据的Widget中使用
Consumer<UserDataProvider>(
  builder: (context, provider, child) {
    return FutureBuilder<String>(
      future: provider.getUserField('目标用户uid', 'full_name'),
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          return const Text("loading");
        }
        return Text(snapshot.data!);
      },
    );
  },
)

关键说明 #

• 直接写Text(myfunction(uid, value))不可行，因为异步函数返回的是Future<String>，必须用FutureBuilder处理加载、完成、错误等状态。
• 函数中加入了文档存在性、字段存在性检查和异常捕获，避免运行时崩溃。
• 若需复用该逻辑，可以把FutureBuilder封装成自定义Widget，简化多处调用的代码。

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