Flutter拉取Firebase Storage图片报Undefined name 'storage'错误解决

编写从Firebase Storage检索图片的方法时，运行抛出如下报错：

Undefined name 'storage'. Try correcting the name to one that is defined, or defining the name

错误指向代码中storage.ref('pizza').list()行，原始实现代码如下：

Future<List<Map<String, dynamic>>> _loadImage() async {
        List<Map<String, dynamic>> files = [];
    
        final ListResult result = await storage.ref('pizza').list();// 此处抛出未定义storage的错误
        final List<Reference> allFiles = result.items;
    
        await Future.forEach<Reference>(allFiles, (file) async {
          final String fileUrl = await file.getDownloadURL();
          final FullMetadata fileMeta = await file.getMetadata();
          files.add({
            "url": fileUrl,
          });
        });
    
        return files;
      }

代码中直接调用了storage对象，但没有提前导入Firebase Storage相关依赖、也没有声明初始化Firebase Storage的实例，Dart无法识别该标识符，因此抛出未定义名称的错误。

• 先确认项目已经完成Firebase基础配置：已添加firebase_core、firebase_storage依赖，且在应用启动时完成了Firebase的初始化（调用Firebase.initializeApp()）。
• 在当前代码文件顶部导入Firebase Storage的对应包，在使用storage标识符前初始化Firebase Storage实例。

修复后的完整可运行代码如下：

// 导入Firebase Storage官方包
import 'package:firebase_storage/firebase_storage.dart';

// 初始化Firebase Storage实例，使用默认存储桶直接取instance即可
final FirebaseStorage storage = FirebaseStorage.instance;

Future<List<Map<String, dynamic>>> _loadImage() async {
  List<Map<String, dynamic>> files = [];

  final ListResult result = await storage.ref('pizza').list();
  final List<Reference> allFiles = result.items;

  await Future.forEach<Reference>(allFiles, (file) async {
    final String fileUrl = await file.getDownloadURL();
    // 原代码中fileMeta变量定义后未使用，可直接删除，避免无意义的网络请求和代码警告
    files.add({
      "url": fileUrl,
    });
  });

  return files;
}

补充：如果使用自定义路径的存储桶，初始化实例时可传入bucket参数指定，写法为FirebaseStorage.instanceFor(bucket: '你的自定义存储桶地址')

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