异步函数返回奇怪null：Firebase Storage上传图片后获取下载URL异常

问题原因 #

你遇到的返回null问题核心是异步返回值没有向上传递到方法顶层，同时混用await和then的写法导致返回链路断裂：

• _uploadImage方法的try块内，你写了await xxx.then(...)，但是then块内部的return只会返回给then方法本身，并不会作为外层_uploadImage方法的返回值
• 整个_uploadImage方法没有显式的顶层return语句，异步执行完成后自然返回null
• 多层嵌套的then回调也会进一步提升返回值传递的复杂度，更推荐统一使用async/await语法简化逻辑

修正后的代码 #

Future<String?> _uploadImage(String fileName, File imageFile) async {
  try {
    // 上传选中的图片并添加自定义元数据，直接await获取上传结果
    final imgUploadTaskSnapshot = await FirebaseStorage.instance
        .ref(fileName)
        .putFile(
            imageFile,
            SettableMetadata(customMetadata: {
              'uploaded_by': 'Some guy',
              'description': 'Some description...'
            }));
    
    // 判断上传状态
    if (imgUploadTaskSnapshot.state == TaskState.success) {
      // 上传成功后直接await获取下载URL，作为方法返回值
      final fileURL = await FirebaseStorage.instance.ref(fileName).getDownloadURL();
      print('url : $fileURL');
      return fileURL;
    }
    // 其他状态返回null，也可以根据需求加错误处理
    return null;
  } on FirebaseException catch (error) {
    print(error);
    throw error;
  }
}

Future<List<String>?> uploadImages(List<Map<String, dynamic>> images) async {
  try {
    List<String> imgsURLs = <String>[];
    for (int i = 0; i < images.length; i++) {
      // 直接用await接收返回值，避免混用then
      final imgURL = await _uploadImage(images[i]['filename'], images[i]['imagefile']);
      print('imgURL: $imgURL');
      if (imgURL != null) {
        imgsURLs.add(imgURL);
      }
    }
    print('imgsURLs: $imgsURLs');
    return imgsURLs;
  } on FirebaseException catch (error) {
    print(error);
    throw error;
  }
}

额外优化建议 #

• 可以在TaskState.error、TaskState.canceled分支加入对应的异常抛出或者日志打印，方便定位上传失败的问题
• 上传前可以增加文件存在性判断，避免重复上传相同文件

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