Flutter电商API请求报错：List<dynamic>无法转为List<String>如何解决？

错误根源 #

这个错误源于类型转换不匹配：代码尝试将List<dynamic>直接转为List<String>，但Dart不允许这种隐式类型转换。问题集中在两个点：

1. fetchAllProducts中冗余的JSON编码/解码操作
2. Product.fromJson方法对列表类型的处理不当

修复步骤 #

1. 移除冗余的JSON编码操作

jsonEncode(jsonDecode(res.body)[i])是完全多余的——jsonDecode(res.body)[i]已经是Map<String, dynamic>类型，直接传给Product.fromJson即可：

修改后的fetchAllProducts代码：

Future<List<Product>> fetchAllProducts(BuildContext context) async {
  final userProvider = Provider.of<UserProvider>(context, listen: false);
  List<Product> productList = [];
  try {
    http.Response res =
        await http.get(Uri.parse('$uri/admin/get-products'), headers: {
      'Content-Type': 'application/json; charset=UTF-8',
      'x-auth-token': userProvider.user.token,
    });

    httpErrorHandle(
      response: res,
      context: context,
      onSuccess: () {
        final List<dynamic> productsJson = jsonDecode(res.body);
        for (var productJson in productsJson) {
          productList.add(
            Product.fromJson(productJson as Map<String, dynamic>),
          );
        }
      },
    );
  } catch (e) {
    showSnackBar(context, e.toString());
  }
  return productList;
}

2. 修正Product.fromJson中的列表类型转换

打开Product类，找到所有需要转为List<String>的字段（如tags、images），将直接类型转换改为显式转换：

错误写法（会触发类型不匹配）：

Product.fromJson(Map<String, dynamic> json) {
  tags = json['tags'] as List<String>;
}

正确写法（两种可选方案）：

// 方案1：用List.from()强制转换元素类型
Product.fromJson(Map<String, dynamic> json) {
  tags = List<String>.from(json['tags'] ?? []);
}

// 方案2：用map逐个转换元素（适合需要额外处理的场景）
Product.fromJson(Map<String, dynamic> json) {
  tags = (json['tags'] as List<dynamic>?)?.map((e) => e.toString()).toList() ?? [];
}

额外建议 #

• 为JSON字段添加空值判断（?? []），避免API返回null导致崩溃
• 使用for-in循环替代索引循环，代码更简洁易读
• 可考虑使用json_serializable包自动生成序列化代码，减少手动转换错误

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