Flutter解析带数组的复杂天气JSON API报类型错误,需控制台输出时间与浪高
报错根因定位
- 核心类型不匹配问题:你在解析时直接把
jsonDecode(response.body)的返回值强转为List,但接口返回的根节点是Map结构(即错误提示里的_InternalLinkedHashMap<String, dynamic>),并非数组,因此直接触发类型转换异常,对应报错栈中标注的代码第25行。 - 解析层级完全错位:
- 原本
hours是根节点下的数组字段,你错误将其类型声明为字符串,还试图从非数组的结构里取数组值; - 原本
waveHeight是每个hours数组元素内部的嵌套对象,你错误从根结构层面直接取这个字段; - 浪高数值是带小数的浮点型,你错误将其类型声明为整型,即使跑通了前面的逻辑,也会在数值转换环节触发新的报错。
- 原本
修正后的可运行解析代码
void getJsonData() async { String url2 = 'https://api.stormglass.io/v2/weather/point?lat=5.9774&lng=80.4288¶ms=waveHeight&start=2021-03-23&end=2021-03-24'; String apiKey = '你的实际接口密钥'; Response response = await get( Uri.parse(url2), headers: {HttpHeaders.authorizationHeader: apiKey} ); // 第一步:根节点为Map结构,直接强转即可 final rootResponseMap = jsonDecode(response.body) as Map<String, dynamic>; // 第二步:从根Map中取出hours字段对应的观测数组 final List hoursObservationList = rootResponseMap['hours']; // 第三步:逐行遍历观测数据 for (final observationItem in hoursObservationList) { // 提取当前条目对应的观测时间 String observationTime = observationItem['time']; // 提取当前条目下嵌套的浪高数据Map Map waveHeightData = observationItem['waveHeight']; // 提取不同数据源的浪高值(注意为浮点数类型) double iconSourceWave = waveHeightData['icon']; double meteoSourceWave = waveHeightData['meteo']; // 按需求在控制台打印对应信息 print('观测时间:$observationTime | icon数据源浪高:$iconSourceWave m | meteo数据源浪高:$meteoSourceWave m'); } }
日常解析注意事项
- 强转操作必须和实际JSON的结构层级严格对应:根节点是对象就转Map,数组节点才转List,不要不分层级直接把整个响应体强转为数组。
- 气象类接口的观测数值普遍为带两位小数的浮点数,不要强制声明为int类型,否则会触发数值转换错误。
- 长期维护场景可以将JSON结构封装为强类型Dart实体类,避免手动取字段时的拼写错误、类型不匹配问题。
内容的提问来源于stack exchange,提问作者Minsaf
相关产品推荐
相关产品推荐

