Flutter调用API解析数据时String不是Description类型子类型报错

架构老林

2026-10-5

问题解决方法

报错原因

你的Branchlist数据模型结构与API实际返回的JSON结构不匹配：模型中description字段的类型被声明为自定义的Description类，但API返回的对应字段实际为纯字符串，类型校验不通过就抛出了type 'String' is not a subtype of type 'Description'错误。

修复步骤

第一步：修改branch_list.dart模型文件中description字段的类型定义，将Description类改为String类型：

// 错误写法示例
class BranchListElement {
  Description description;
  // 其余字段
}

// 修正后写法
class BranchListElement {
  String description;
  // 其余字段
}

第二步：补充状态变量存储解析后的数据，修正接口请求逻辑，解析成功后刷新UI：

// 在_restaurantPageState类中新增状态变量，存储解析后的门店列表
List<BranchListElement> branchList = [];

Future getapidata() async {
  String url =
      "https://www.mobilonsoft.com/fpsapi/default.aspx?op=branch_list&firmuid=feedmekktc&device_id=web_20210813180900001&device_platform=4&lang=en";
  try {
    Response responsee = await get(Uri.parse(url));
    if (responsee.statusCode == 200) {
      Map sonuc = jsonDecode(responsee.body);
      Branchlist liste = Branchlist.fromJson(sonuc);
      // 赋值给状态变量，触发UI刷新
      setState(() {
        branchList = liste.result.branchList;
        counter = branchList.length;
      });
      print(branchList);
    }
  } catch (e) {
    print(e.toString());
    print("verileri çekerken hata oluştu");
  }
}

第三步：修正ListView渲染逻辑，使用解析后的门店列表数据渲染：

itemBuilder: (context, index) {
  final currentBranch = branchList[index];
  return ListTile(
    title: Text(currentBranch.branchName),
    subtitle: Text(currentBranch.description),
    leading: CircleAvatar(
      backgroundImage: NetworkImage(currentBranch.branchImg ?? ""),
    ),
  );
}