移除String类型Map元素时键值异常问题排查

你定义了Map<String, String> data = {};存储用户输入项，但移除元素时出现键混乱和空值，以下是具体原因分析：

你的代码片段 #

// onChanged时调用
if (data.containsKey('$index') && value != null) {
   data['$index'] = value!;
}

// 移除时调用
data.remove('$index');
data.removeWhere((key, value) => key == "");

// 打印结果
print(json.encode(data));

输出对比 #

• 移除前：{"0":"Manager","1":"Service","2":"Sales","3":"Reception"}
• 移除后实际输出：{"0":"Manager","1":"Service","3":"Reception","4":""}
• 期望输出：{"0":"Manager","1":"Service","2":"Sales"}

问题原因 #

1. 键不会自动重新编号：你直接用原索引值作为Map的键，移除指定键后，剩余键的编号不会自动调整。比如移除键"2"后，原来的键"3"会保留，不会变成"2"，自然导致键序列不连续。
2. 空值来自UI索引不同步：键"4"的空值，大概率是移除操作后，动态生成输入项的UI逻辑没同步更新索引。比如原本4个项（索引0-3），移除一个后，UI错误生成了索引为4的空输入项，且有额外逻辑把这个空值写入了Map（你的onChanged代码只处理已存在的键，所以空值是其他逻辑添加的）。
3. 无效的移除逻辑：data.removeWhere((key, value) => key == "");这行完全没用，你的键都是数字字符串，不会出现空键，直接删掉即可。

解决思路 #

如果需要移除元素后键保持连续的数字序列，不能直接删除原键，要重新构建Map：

// 移除指定索引的元素后
data.remove('$index');
// 过滤空值并重新生成连续键的Map
List<String> validValues = data.values.where((val) => val.isNotEmpty).toList();
data = Map.fromIterable(
  validValues,
  key: (item) => '${validValues.indexOf(item)}',
  value: (item) => item,
);

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