Flutter使用Firestore拉取数据时报Null check operator used on a null value错误

• 你将异步的Firestore查询方法getUserData()写在了build函数内，Flutter首次渲染页面时，异步请求还未返回结果，userData里的data字段还未赋值，此时你使用!强制解包空值就会触发该错误。另外build函数会在页面重绘时多次执行，也会导致重复发起不必要的查询请求。
• 没有做异常兜底，当请求失败、对应uid的用户文档不存在、文档内缺少userName字段时，强制解包都会触发空值报错。
• 你Api Service中获取userId的逻辑如果返回空值，会导致查询到不存在的文档，最终userData也无法拿到有效值。

以下是修改后的HomeScreen代码：

class _HomeState extends State<Home> {
  Map<String, dynamic>? userData = {};
  PanelController _panelController = PanelController();
  // 新增加载状态标记请求进度
  bool isLoading = true;

  @override
  void initState() {
    super.initState();
    // 初始化阶段只执行一次数据请求
    _loadUserData();
  }

  Future<void> _loadUserData() async {
    try {
      DocumentSnapshot documentSnapshot = await getUserData();
      if (documentSnapshot.exists && documentSnapshot.data() != null) {
        setState(() {
          userData = {"data": documentSnapshot.data()};
        });
      }
    } catch (err) {
      // 可自行添加错误提示逻辑
      debugPrint("获取用户数据失败：$err");
    } finally {
      setState(() {
        isLoading = false;
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: CustomAppbar(
        title: translate("APP_BAR.TITLE.HOME"),
        canBack: false,
      ),
      body: Stack(
        fit: StackFit.expand,
        children: <Widget>[
          // 加载阶段显示占位，非加载阶段用安全调用+默认值兜底
          isLoading
              ? const Center(child: CircularProgressIndicator())
              : Text(userData?['data']?['userName'] ?? '用户名未设置')
        ],
      ),
      drawer: CustomDrawer(),
    );
  }
}

• 把异步请求从build函数移到initState中，页面初始化时仅发起一次请求，避免重复调用和渲染时序冲突
• 新增isLoading状态，请求未完成时显示加载动画，不会提前渲染用户信息字段
• 把所有!强制解包替换为?.安全调用，配合??设置默认值，就算某层级字段为空也不会抛出异常

检查Api Service中的userId取值逻辑，确保getData(user_uid)返回的用户id非空，用户未登录时要增加拦截逻辑，避免查询不存在的文档。

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