使用字符串变量作为Map键取值始终返回null的问题求助

直接说实际开发里踩过的坑和解决办法：

最常见问题：字符串表面相同，实际有差异 #

用变量str取值返回null，但字面量能拿到值，90%是因为str的字符串和Map里的键看起来一样，实际内容有区别：

• 隐藏空白字符：比如str首尾带空格、制表符，或者Map里的键混了看不见的换行符，肉眼看不出但实际是不同字符串。
• 大小写不一致：比如Map里的键是"Fruit"，变量是"fruit"，大小写不匹配导致匹配失败。
• 全角/半角差异：不小心用了全角字母，编码不同导致无法匹配。

排查步骤 #

1. 对比长度：打印变量str和字面量"fruit"的长度，不一样就肯定有问题：

   // 以Kotlin为例，其他语言写法类似
   println(str.length)
   println("fruit".length)
   

2. 打印字符编码：逐个输出字符的ASCII码，直接找出差异：

   str.forEach { println(it.code) }
   "fruit".forEach { println(it.code) }
   

解决办法 #

• 清理空白字符：如果是首尾空白，直接用trim()处理变量：

  str = str.trim()
  // 中间有空白的话用正则替换
  str = str.replace("\\s+".toRegex(), "")
  

• 统一大小写：创建Map时把键转成小写（或大写），变量也同步转换后再取值：

  val myMap = mapOf(
      "fruit".lowercase() to 25,
      "veg".lowercase() to 30,
      "baked".lowercase() to 35,
      "flower".lowercase() to 40
  )
  val v = myMap[str.lowercase()]
  

另一种可能：Map键的类型不是String #

比如不小心把键存成了StringBuilder、CharSequence这类和String相似但不同的类型，比如Java里的错误写法：

// 错误：键类型是Object，存的是StringBuilder
Map<Object, Integer> myMap = new HashMap<>();
myMap.put(new StringBuilder("fruit"), 25);

String str = "fruit";
myMap.get(str); // 返回null，因为类型不匹配

解决办法是确保Map键的类型为String，存值时也用String类型的键：

Map<String, Integer> myMap = new HashMap<>();
myMap.put("fruit", 25);
String str = "fruit";
myMap.get(str); // 正常返回25

总结 #

优先排查字符串内容的差异（空白、大小写），再确认键的类型是否匹配，这两个点基本能解决你的问题——2500个键值对的场景，不可能是Map本身的bug，大概率是字符串匹配的细节问题。

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