Flutter调用天气API时snapshot.data类型不匹配报错如何解决

这个报错是因为未给FutureBuilder指定泛型，Dart默认将snapshot.data推断为Object?类型，和Weather类型不匹配导致的，按以下步骤修改即可： #

1. 给FutureBuilder添加泛型约束 #

找到currentWeather.dart中FutureBuilder的定义，显式指定泛型为Weather：

// 原错误写法，无泛型约束
FutureBuilder(
  future: fetchWeatherMethod(), // 你的请求天气的异步方法
  builder: (context, snapshot) {
    // 原有逻辑
  }
)

// 修改后写法
FutureBuilder<Weather>(
  future: fetchWeatherMethod(),
  builder: (context, snapshot) {
    // 原有逻辑
  }
)

2. 补充状态判断，处理空值场景 #

snapshot.data在请求未完成、请求失败时为空，需要先判断状态再取值，避免空安全报错：

builder: (context, AsyncSnapshot<Weather> snapshot) {
  // 请求加载中
  if (snapshot.connectionState == ConnectionState.waiting) {
    return const Center(child: CircularProgressIndicator());
  }
  // 请求出错
  if (snapshot.hasError) {
    return Center(child: Text('加载失败: ${snapshot.error.toString()}'));
  }
  // 请求成功，取值
  Weather _weather = snapshot.data!;
  // 后续渲染天气UI的逻辑
  // ...
}

临时兜底方案（不推荐） #

如果不想修改FutureBuilder的泛型定义，也可以对取值做强制类型转换：

Weather _weather = snapshot.data as Weather;

额外检查项 #

• 确保你的请求天气的异步方法返回值类型为Future<Weather>，如果方法返回值类型不匹配也会触发同类报错
• 检查Weather实体类的fromJson解析逻辑没有类型错误，避免运行时转换异常

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