Flutter中如何将Future<String?>转换为Future<String>?类型

使用network_info_plus包读取设备当前连接的WiFi名称时，计划通过FutureBuilder接收info.getWifiName()返回的Future对象，但该方法返回值类型为Future<String?>，无法直接赋值给FutureBuilder<String>的future参数，报错信息如下：

The argument type 'Future<String?>' can't be assigned to the parameter type 'Future<String>?'

原问题示例代码：

NetworkInfo info = NetworkInfo();
...
FutureBuilder<String>(
  future: info.getWifiName(), // 此处触发类型不匹配错误
  builder: (BuildContext context, AsyncSnapshot<String> snapshot) {
    ...
  }
)

getWifiName()返回可空类型是符合实际场景的：当设备未连接WiFi、未授予对应权限、系统限制读取WiFi信息时，方法会返回null，因此不推荐直接使用强制类型转换，否则极易触发运行时崩溃。可根据业务场景选择以下两种方案：

方案1：调整FutureBuilder泛型适配可空返回值（优先推荐） #

直接将FutureBuilder的泛型声明为可空的String?，在builder逻辑中单独处理null场景，完全符合API的设计逻辑，代码健壮性最高：

FutureBuilder<String?>(
  future: info.getWifiName(),
  builder: (BuildContext context, AsyncSnapshot<String?> snapshot) {
    // 等待加载状态
    if (snapshot.connectionState != ConnectionState.done) {
      return const CircularProgressIndicator();
    }
    // 处理错误场景
    if (snapshot.hasError) {
      return Text('WiFi信息获取失败');
    }
    final wifiName = snapshot.data;
    // 处理返回null的场景
    if (wifiName == null) {
      return const Text('未检测到有效WiFi连接，请检查权限与网络状态');
    }
    return Text('当前连接WiFi：$wifiName');
  }
)

方案2：做空值兜底转换为非空类型 #

如果业务逻辑要求必须接收非空String类型，可以在调用时为null场景设置默认兜底值，将Future<String?>转换为Future<String>：

FutureBuilder<String>(
  // 为null时返回默认值"未知WiFi"
  future: info.getWifiName().then((value) => value ?? '未知WiFi'),
  builder: (BuildContext context, AsyncSnapshot<String> snapshot) {
    if (snapshot.connectionState != ConnectionState.done) {
      return const CircularProgressIndicator();
    }
    return Text('当前连接WiFi：${snapshot.data}');
  }
)

注意：禁止使用info.getWifiName() as Future<String>做强制类型转换，一旦方法返回null，会直接抛出类型转换异常导致页面崩溃。

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