Dart/Flutter：嵌套Map中按Key删除元素时遭遇并发修改错误

错误原因 #

在使用Map.forEach()遍历Map时直接调用map.remove(key)修改Map结构，会触发Concurrent modification during iteration错误。因为forEach迭代过程中，Map的结构（键的数量）不允许被修改，否则会破坏迭代的一致性。

解决方案 #

方法1：先收集待删除的键，遍历完成后批量删除 #

先遍历Map，把需要删除的键存入临时列表，等遍历结束后再统一删除，避免迭代时修改Map结构：

void main() {
  Map<String, dynamic> nestedMap = {
    'key1': 'value1',
    'key2': {
      'nestedKey1': 'nestedValue1',
      'nestedKey2': 'nestedValue2',
    },
    'key3': {
      'nestedKey3': {
        'nestedKey4': 'nestedValue3',
      },
    },
  };

  String keyToRemove = 'nestedKey2';

  removeKeyFromNestedMap(nestedMap, keyToRemove);
  print(nestedMap);
}

void removeKeyFromNestedMap(Map<String, dynamic> map, String keyToRemove) {
  final keysToDelete = <String>[];
  
  map.forEach((key, value) {
    // 递归处理嵌套Map
    if (value is Map) {
      removeKeyFromNestedMap(value, keyToRemove);
    }
    // 记录需要删除的键
    else if (key == keyToRemove) {
      keysToDelete.add(key);
    }
  });
  
  // 批量删除已记录的键
  for (final key in keysToDelete) {
    map.remove(key);
  }
}

方法2：使用迭代器的remove()方法 #

Dart的Map迭代器支持在迭代过程中安全删除元素，直接调用iterator.remove()即可：

void main() {
  Map<String, dynamic> nestedMap = {
    'key1': 'value1',
    'key2': {
      'nestedKey1': 'nestedValue1',
      'nestedKey2': 'nestedValue2',
    },
    'key3': {
      'nestedKey3': {
        'nestedKey4': 'nestedValue3',
      },
    },
  };

  String keyToRemove = 'nestedKey2';

  removeKeyFromNestedMap(nestedMap, keyToRemove);
  print(nestedMap);
}

void removeKeyFromNestedMap(Map<String, dynamic> map, String keyToRemove) {
  final iterator = map.entries.iterator;
  
  while (iterator.moveNext()) {
    final entry = iterator.current;
    
    // 递归处理嵌套Map
    if (entry.value is Map) {
      removeKeyFromNestedMap(entry.value, keyToRemove);
    }
    // 使用迭代器安全删除当前元素
    else if (entry.key == keyToRemove) {
      iterator.remove();
    }
  }
}

这两种方法都能解决并发修改的问题，同时正确递归处理所有嵌套层级的Map。

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