Java中HashMap.get()传入有效Key却返回null的问题排查

我来帮你排查这个HashMap.get()传入有效Key却返回null的问题，结合你贴的代码，主要有几个常见的原因和解决思路：

1. Key的类型完全不匹配 #

这是最容易踩的坑！比如你从JSON转成Map后，Key的实际类型和你调用get()时传入的类型不一样——比如JSON里的键是数字字符串（比如"123"），但某些JSON库会自动把它转成Integer类型，这时候你用String类型的"123"去get，自然返回null。

举个例子：

// 假设JSON转换后的Map实际是这样
Map data = new HashMap();
data.put(123, "testValue"); // Key是Integer类型
System.out.println(data.get("123")); // 传入String类型Key，返回null

解决办法：
先打印Map里所有Key的类型和值，确认和你传入的Key完全一致：

for (Map.Entry entry : data.entrySet()) {
    System.out.println("Key类型: " + entry.getKey().getClass() + ", Key值: " + entry.getKey());
}

之后确保调用get()时用的Key类型和Map中存储的完全匹配。

2. Constant类的静态方法存在线程安全问题 #

你写的Constant.g()方法里，constantConfig的初始化没有做线程同步。如果多个线程同时调用这个方法，可能会出现constantConfig还没加载完成就被调用的情况，导致返回null甚至抛出空指针异常。

优化方案：
要么用静态初始化块（类加载时执行一次，天然线程安全）：

public class Constant {
    private static Properties constantConfig;

    static {
        try {
            constantConfig = new Properties();
            String configPath = System.getProperty("user.dir") + "/" + "constants.properties";
            constantConfig.load(new FileInputStream(configPath));
        } catch (IOException e) {
            // 不要只打印栈轨迹，直接抛出运行时异常终止程序，避免后续使用null的配置
            throw new RuntimeException("加载constants.properties配置文件失败", e);
        }
    }

    public static String g(String property) {
        return constantConfig.getProperty(property);
    }
}

如果需要延迟加载（只有第一次调用时才加载），就用双重检查锁+volatile：

public class Constant {
    // volatile防止指令重排，确保多线程下看到的是完整初始化的对象
    private static volatile Properties constantConfig;

    public static String g(String property) {
        if (constantConfig == null) {
            synchronized (Constant.class) {
                if (constantConfig == null) {
                    try {
                        constantConfig = new Properties();
                        String configPath = System.getProperty("user.dir") + "/" + "constants.properties";
                        constantConfig.load(new FileInputStream(configPath));
                    } catch (IOException e) {
                        throw new RuntimeException("加载constants.properties配置文件失败", e);
                    }
                }
            }
        }
        return constantConfig.getProperty(property);
    }
}

3. JSON转换时的Key被意外修改 #

有些JSON库（比如Jackson、Gson）在转换时，如果你的配置不对，可能会修改Key的格式——比如把驼峰命名转成下划线，或者自动去除前后空格，甚至把特殊字符转义。这会导致你以为的“有效Key”和Map里实际存储的Key不一致。

解决办法：
直接打印Map的所有Key，和原始JSON里的键做对比：

System.out.println("Map中所有Key: " + data.keySet());

如果发现格式不一致，检查JSON库的转换配置，比如Jackson的PropertyNamingStrategy是否被修改过。

4. 自定义Key对象未重写equals/hashCode #

如果你的Map的Key是自定义类对象，一定要确保正确重写了equals()和hashCode()方法——否则HashMap会认为两个内容相同的对象是不同的Key，导致get()返回null。不过如果你的Key是String或基本类型包装类，这个问题可以忽略，因为它们已经正确重写了这两个方法。

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