Release构建下WiFi无法联网但移动数据正常，且报Future.then类型错误

核心问题解析 #

Release模式下Dart会开启严格的类型校验和编译优化，而Debug模式的类型推断相对宽松，所以Future.then must return a value of the returned future's type这个错误只会在Release阶段触发。这个异步回调的类型不匹配问题会直接中断网络请求的逻辑流程，导致你看到WiFi下无法联网的现象——本质不是WiFi本身的问题，是代码错误阻断了网络操作。

具体修复步骤 #

• 全局排查所有Future.then的使用场景，确保回调函数的返回值类型和外层Future的泛型类型完全一致。
  举个典型错误示例：

  Future<String> getNetworkData() {
    return http.get(Uri.parse("https://example.com")).then((resp) {
      // 这里返回了int类型，和Future<String>的泛型不匹配
      return resp.statusCode;
    });
  }
  

  修正后的写法：

  Future<String> getNetworkData() {
    return http.get(Uri.parse("https://example.com")).then((resp) {
      return resp.body; // 返回String类型，匹配外层Future的泛型
    });
  }
  

• 如果异步回调不需要返回值，要明确外层Future的类型为Future<void>，且回调要么显式返回null，要么省略return（Dart会默认返回null）：

  Future<void> processData() {
    return getNetworkData().then((data) {
      print("拿到数据：$data");
      return null;
    });
  }
  

• 推荐用async/await替代then链式调用，代码可读性更高，类型校验也更直观，不容易出现这类问题：

  Future<String> getNetworkData() async {
    final resp = await http.get(Uri.parse("https://example.com"));
    return resp.body;
  }
  

验证方法 #

修复后直接打包Release版本测试WiFi环境，确认错误消失且联网正常。另外可以提前运行dart analyze命令，静态检测代码中的类型不匹配问题，避免到Release阶段才暴露。

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