使用Dart的json.removeWhere()移除null元素时遇类型错误的解决方法

错误原因 #

你遇到的类型错误核心是调用removeWhere的对象类型与传入的回调函数不匹配：

• 单层Map使用Map.removeWhere()时，回调要求是bool Function(K key, V value)（接收键和值两个参数），这和你之前的用法匹配，所以运行正常。
• 但当前处理的是嵌套JSON结构（比如features对应List<Map<String, Object?>>类型），对List调用removeWhere()时，它的回调仅接受bool Function(E element)（单个元素参数）。如果你仍传入带两个参数的回调，就会触发类型不匹配——错误信息明确显示，你传递的是双参数函数，但方法只接受单参数函数。
• 另外，features可能为null，直接调用removeWhere还会触发空指针异常，这也是需要提前处理的点。

解决办法 #

1. 区分Map和List的removeWhere回调格式

• 处理顶层Map的null值：使用双参数回调判断键值对

  Map<String, dynamic> jsonData = {"name": "test", "features": null, "id": 123};
  // 移除顶层Map中值为null的键值对
  jsonData.removeWhere((key, value) => value == null);
  

• 处理List中的null元素：使用单参数回调判断元素

  // 先判断features是否为List，避免空指针
  if (jsonData['features'] is List) {
    List featuresList = jsonData['features'] as List;
    // 移除列表中值为null的元素
    featuresList.removeWhere((element) => element == null);
  }
  

• 处理List内嵌套Map的null字段：遍历每个Map单独处理

  if (jsonData['features'] is List) {
    List featuresList = jsonData['features'] as List;
    for (var item in featuresList) {
      if (item is Map) {
        // 移除每个Map中的null字段
        item.removeWhere((key, value) => value == null);
      }
    }
  }
  

2. 完整安全处理示例

void cleanNestedJson(Map<String, dynamic> jsonData) {
  // 移除顶层Map的null键值对
  jsonData.removeWhere((key, value) => value == null);
  
  // 处理features列表及其内部Map
  if (jsonData['features'] is List) {
    List featuresList = jsonData['features'] as List;
    // 移除列表中的null元素
    featuresList.removeWhere((element) => element == null);
    // 清理每个Map的null字段
    for (var feature in featuresList) {
      if (feature is Map) {
        feature.removeWhere((key, value) => value == null);
      }
    }
  }
}

3. 关键注意点

• Map.removeWhere() 回调参数是(key, value)
• List.removeWhere() 回调参数是(element)
• 所有嵌套结构操作前必须做类型/空检查，避免运行时异常

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