Java中HashMap取出的字符串与普通字符串相等比较不生效问题

问题原因 #

导致该问题的核心原因是两个看起来值都是123的字符串，实际包含肉眼不可区分的差异，常见的场景有以下几种：

• 字符串前后/中间夹带了不可见字符：比如空格、制表符、换行符、回车符。Scanner读取输入时如果残留了之前输入的换行符，或者用户输入时不小心多打了空格，又或者HashMap中存储密码时误加了空白字符，打印时这些不可见字符不会显示出来，看起来就都是123。
• 字符编码格式差异：比如其中一个是全角的１２３，另一个是半角的123，视觉上几乎没有区别，但字符的实际编码值完全不同，equals判断自然返回false。
• 特殊场景下的类型问题：如果LoginDetailsPojo中的password字段不是String类型（比如是char数组、自定义类型），赋值给String userPassword时触发了隐式toString，实际和HashMap中存储的字符串值存在差异。

解决方法 #

你可以按照以下步骤排查修复：

1. 先校验两个字符串的长度，确认是否存在隐藏字符：

System.out.println("用户输入密码长度：" + userPassword.length());
System.out.println("库取密码长度：" + mapPassword.length());

如果输出长度不一致，就可以确定存在不可见字符，直接调用trim()方法去除前后空白后再比较即可：

if(userPassword.trim().equals(mapPassword.trim())){
    System.out.println("两者相等");
}

2. 如果长度一致仍不相等，可以打印每个字符的ASCII编码确认差异：

for(char c : userPassword.toCharArray()){
    System.out.print((int)c + " ");
}
System.out.println();
for(char c : mapPassword.toCharArray()){
    System.out.print((int)c + " ");
}

如果是全角半角问题，编码值会明显不同，只需要统一转成全角/半角后再比较即可。
3. 优化校验逻辑避免空指针风险，推荐使用java.util.Objects.equals做比较：

if(Objects.equals(userPassword.trim(), mapPassword.trim())){
    System.out.println("两者相等");
}

4. 源头优化：Scanner读取密码时优先使用next()方法替代nextLine()，会自动忽略输入前后的空白字符，减少不必要的隐藏字符问题。

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