Guava Cache异常：仅返回缓存结果未从数据库查询问题排查

你遇到的这个问题其实是Guava Cache使用中非常常见的一个坑——你的Profile类没有正确重写equals()和hashCode()方法，导致Guava Cache无法区分不同的查询参数组合，错误地把所有Profile实例当成同一个缓存键，直接返回缓存里的旧数据，完全不会触发CacheLoader的load()方法去数据库拉取新结果。

为什么会这样？ #

Guava Cache是通过键对象的equals()和hashCode()方法来识别唯一缓存条目的。默认情况下，Java对象的这两个方法是基于内存引用实现的：只有当两个对象是同一个实例时，才会被判定为相等。但你的服务层每次处理请求都会新建一个Profile实例（new Profile()），按道理应该被视为不同的缓存键，但因为没重写方法，Guava Cache无法根据name和department这两个实际查询字段来区分不同的请求，反而错误地将所有这些新实例判定为同一个键——所以第一次请求的结果被缓存后，后续所有不同参数的请求都命中同一个缓存条目，自然不会去调用DAO查询。

你提到缩短缓存过期时间后会触发DAO加载，这只是因为缓存过期后Guava Cache会强制重新调用load()方法，但这只是临时 workaround，根本问题还是键的识别逻辑错误。

怎么解决？ #

只需要给Profile类重写equals()和hashCode()方法，基于name和department这两个查询字段来实现即可。这样Guava Cache就能正确区分不同的参数组合，当缓存中没有对应条目时，就会自动触发load()方法去数据库获取数据。

手动实现示例：

import java.util.Objects;

public class Profile {
    // 你的其他字段和方法
    
    private String name;
    private String department;

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Profile profile = (Profile) o;
        return Objects.equals(name, profile.name) && Objects.equals(department, profile.department);
    }

    @Override
    public int hashCode() {
        return Objects.hash(name, department);
    }

    // getter和setter方法
}

如果你使用Lombok的话，更简单，只需要在Profile类上添加注解：

import lombok.EqualsAndHashCode;

@EqualsAndHashCode(of = {"name", "department"})
public class Profile {
    // 你的字段和方法
}

验证效果 #

重写之后，不同name或department的Profile实例会被Guava Cache视为不同的缓存键：

• 当缓存中没有对应条目时，CacheLoader的load()方法会被调用，打印你设置的日志，同时从DAO获取数据并缓存；
• 相同参数的请求会直接命中缓存，提升性能；
• 再也不会出现“返回最后一条缓存记录”的问题了。

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