Spring Data JPA如何将自然键作为应用上下文缓存键优化查询

方案1：基于Hibernate自然键缓存实现（适配你现有自然键的技术选型） #

你之前的代码未生效的核心原因是未给email字段标注Hibernate自然键注解，也未开启自然键缓存配置，按以下步骤改造即可：

1. 修改User实体类，补充自然键相关配置：

@Getter
@NoArgsConstructor
@AllArgsConstructor
@Builder
@Entity
// 可选：开启二级缓存，跨事务共享缓存时需要
@Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
@NaturalIdCache
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // 标注为自然键，mutable设为false表示字段不可修改，性能更高
    @NaturalId(mutable = false)
    private String email;
}

2. 改造UserRepository的findByEmail方法，添加查询提示启用自然键缓存：

import org.hibernate.jpa.QueryHints;
import org.springframework.data.jpa.repository.QueryHints;

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    @QueryHints(value = {
        @QueryHint(name = QueryHints.HINT_NATURAL_ID_CACHEABLE, value = "true")
    })
    User findByEmail(String email);
}

3. （可选）开启Hibernate二级缓存配置，实现跨事务缓存共享，在application.yml中添加配置：

spring:
  jpa:
    properties:
      hibernate:
        cache:
          use_second_level_cache: true
          use_query_cache: true
          # 可根据需求替换为Redis等其他缓存区域工厂
          region:
            factory_class: org.hibernate.cache.jcache.JCacheRegionFactory

改造完成后，同事务内的多次findByEmail调用只会触发一次SQL查询，开启二级缓存后跨事务调用也会命中缓存。

方案2：基于Spring Cache抽象实现（通用无绑定，更灵活） #

如果不想绑定Hibernate原生特性，可以用Spring官方的缓存抽象实现，适配任意缓存中间件：

1. 项目启动类添加@EnableCaching注解，开启Spring缓存功能
2. 直接给findByEmail方法添加缓存注解即可：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    // 缓存名称为userCache，缓存key为传入的email参数
    @Cacheable(value = "userCache", key = "#email")
    User findByEmail(String email);
}

3. 按需配置缓存实现，本地开发可以直接用Spring默认的ConcurrentMap缓存，生产环境可切换为Redis、Caffeine等实现，无需修改业务代码。

注意事项 #

• 如果使用Hibernate一级缓存，仅在同一事务上下文内生效，跨事务需要开启二级缓存或使用Spring Cache
• 自然键建议设为不可变字段，避免缓存数据不一致问题

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