Flutter报错：The method 'getNotes' was called on null 如何解决？

Hey，我来帮你搞定这个The method 'getNotes' was called on null的错误。这个问题本质是调用getNotes()的FirestoreService实例为null，再加上你的StreamBuilder逻辑有漏洞，导致了连锁问题。下面一步步来修复：

1. 先解决核心问题：Firebase未初始化导致单例失效 #

这个错误最常见的原因是你没有在应用启动时初始化Firebase。从FlutterFire的新版本开始，必须手动初始化Firebase，否则Firestore.instance（或新版的FirebaseFirestore.instance）会抛出异常，导致你的FirestoreService单例创建失败，最终返回null。

修复步骤： #

• 在main.dart中添加Firebase初始化代码：

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'home.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 必须先初始化Firebase
  await Firebase.initializeApp();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Notes App',
      home: HomePage(),
    );
  }
}

• 如果你还没添加firebase_core依赖，在pubspec.yaml中补充：

dependencies:
  flutter:
    sdk: flutter
  cloud_firestore: ^4.8.0 # 用你项目适配的版本
  firebase_core: ^2.15.0 # 同上

2. 修复StreamBuilder的逻辑漏洞 #

你的home.dart里的StreamBuilder有两个致命问题：

• 条件判断逻辑完全搞反了，if(snapshot.hasError || snapshot.hasData)的写法完全错误
• 没有return语句，导致不管快照状态如何，都会执行后面的ListView.builder，当snapshot.data为null时会触发另一个空指针错误

修改后的home.dart代码：

import 'package:flutter/material.dart';
import 'package:notesapp/data/firestore_services.dart';
import 'package:notesapp/data/model/note.dart';

class HomePage extends StatelessWidget{
  @override
  Widget build(BuildContext context){
    return Scaffold(
      appBar: AppBar(
        title: Text('Notes'),
      ),
      body: StreamBuilder(
        stream: FirestoreService().getNotes() ,
        builder: (BuildContext context, AsyncSnapshot<List<Note>> snapshot){
          // 加载中：显示进度条
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }
          // 有错误：显示错误信息
          if (snapshot.hasError) {
            return Center(child: Text('出错了：${snapshot.error}'));
          }
          // 无数据：显示提示
          if (!snapshot.hasData || snapshot.data!.isEmpty) {
            return const Center(child: Text('还没有笔记哦'));
          }
          // 有数据：渲染列表
          return ListView.builder(
            itemCount: snapshot.data!.length,
            itemBuilder: (BuildContext context, int index){
              Note note = snapshot.data![index];
              return ListTile(
                title: Text(note.title ?? '无标题'), // 兼容字段为null的情况
                subtitle: Text(note.description ?? '无内容'),
              );
            },
          );
        },
      ),
    );
  }
}

3. 适配新版Cloud Firestore（可选） #

如果你用的是新版cloud_firestore（v3+），旧的API已经被废弃，需要同步更新firestore_services.dart的代码：

import 'package:cloud_firestore/cloud_firestore.dart';
import 'model/note.dart';

class FirestoreService {
  static final FirestoreService _firestoreService = FirestoreService._internal();
  final FirebaseFirestore _db;

  // 用初始化列表确保_db非空
  FirestoreService._internal() : _db = FirebaseFirestore.instance;

  factory FirestoreService() {
    return _firestoreService;
  }

  Stream<List<Note>> getNotes() {
    return _db.collection('notes').snapshots().map(
          (snapshot) => snapshot.docs.map( // 新版用docs代替documents
            (doc) => Note.fromMap(doc.data(), doc.id), // 新版用id代替documentID
          ).toList(),
        );
  }
}

最后检查 #

• 确保Firebase控制台已经创建了notes集合，并且有测试数据
• 确认你的项目已经正确配置了Firebase（Android的google-services.json或iOS的GoogleService-Info.plist已添加）

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