Flutter上传图片到Firebase Storage报非空返回类型错误如何解决

开发Flutter应用实现图片上传至Firebase Storage功能时，遇到如下编译报错：

The body might complete normally, causing 'null' to be returned, but the return type, 'FutureOr', is a potentially non-nullable type. Try adding either a return or a throw statement at the end.

报错含义：函数体可能在正常执行完成后返回null，但函数声明的返回类型FutureOr<Void>属于潜在非空类型，编译器提示需要在函数末尾添加return语句或throw语句，保证不会返回null。

import 'dart:ffi';
import 'dart:io';

import 'package:firebase_storage/firebase_storage.dart' as firebase_storage;
import 'package:firebase_core/firebase_core.dart' as firebase_core;

class Storage {
  final firebase_storage.FirebaseStorage storage =
      firebase_storage.FirebaseStorage.instance;

  Future<Void> uploadFile(
    String filepath,
    String filename,
  ) async {
    File file = File(filepath);

    try {
      await storage.ref('pizza/$filename').putFile(file);
    } on firebase_core.FirebaseException catch (e) {
      print(e);
    }
    
  }
}

• 导包错误：代码中导入了dart:ffi包，写返回类型时误用了该包下的Void类型（FFI专用的原生交互类型），而非Dart内置的无返回值类型void。Void不是Dart常规业务场景使用的类型，编译器会要求函数必须返回对应类型的非空实例，不允许隐式返回null。
• 逻辑分支无返回：当前函数的try块、catch块执行完成后都没有显式返回值，对于非void的Future返回类型，Dart空安全机制会判定存在返回null的风险，直接抛出编译错误。

• 删除无用的import 'dart:ffi';导包语句，普通Firebase上传逻辑不需要用到原生FFI相关能力。
• 将uploadFile方法的返回类型从Future<Void>修改为Future<void>，void是Dart内置的无返回值类型，异步方法声明为Future<void>时不需要显式return具体值，符合无返回值的业务逻辑预期。
• （可选）如果需要上层调用方感知上传异常，可以在catch块中添加rethrow;把异常向上抛出，不要直接在当前方法内吞掉错误。

修复后的可正常运行代码如下：

import 'dart:io';

import 'package:firebase_storage/firebase_storage.dart' as firebase_storage;
import 'package:firebase_core/firebase_core.dart' as firebase_core;

class Storage {
  final firebase_storage.FirebaseStorage storage =
      firebase_storage.FirebaseStorage.instance;

  Future<void> uploadFile(
    String filepath,
    String filename,
  ) async {
    File file = File(filepath);

    try {
      await storage.ref('pizza/$filename').putFile(file);
    } on firebase_core.FirebaseException catch (e) {
      print(e);
      // 需要上层处理异常时取消下面这行的注释
      // rethrow;
    }
  }
}

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