오늘은 Spring Cache에서 자주 쓰이는 3대 어노테이션인 @Cacheable, @CachePut, @CacheEvict에 대해 알아보자 ❗

Spring Cache는 메서드의 실행 결과를 자동으로 캐시에 저장하거나 갱신하거나 제거할 수 있게 해주는 선언적 캐싱 기능을 제공한다. 오늘은 그 핵심 어노테이션인 @Cacheable, @CachePut, @CacheEvict에 대해 알아보자

---

1 . 💲 @Cacheable이란?

• 캐시에 데이터가 있으면 DB나 API 호출 없이 캐시에서 바로 꺼내오는 방식이다.
• 즉, 이미 존재하면 캐시에서 가져오고 없으면 실행 후 결과를 캐시에 저장한다는 개념이다.
• 주로 조회( READ ) 성격이 강한 메서드에서 자주 사용된다.

핵심 키워드 : 조회 최적화

@Cacheable(value = "books", key = "#id")
public Book findBookById(Long id) {
	log.info("DB 조회 실행!");
    return bookRepository.findById(id).orElseThrow();
}

• 첫 호출 시에는 DB에서 가져오고 캐시에 저장
• 그 다음 호출부터는 DB를 거치지 않고 캐시에서 반환 ( 로그가 찍히지 않는다. )

---

2 . 📝 @CachePut이란?

• 캐시를 무조건 갱신( update )한다.
• 메서드는 항상 실행되고, 그 결과가 캐시에 반영된다.
• 주로 데이터 변경( update ) 작업 이후 캐시를 최신 상태로 유지할 때 사용한다.

핵심 키워드 : 캐시 동기화

@CachePut(value = "books", key = "#book.id")
public Book updateBook(Book book) {
	log.info("DB 수정 + 캐시 갱신 실행!");
    return bookRepository.save(book);
}

• DB에 반영된 최신 데이터를 곧 바로 캐시에도 덮어써서 조회 시 오래된 캐시가 반환되는 문제를 예방 !

---

3 . 🧹 @CacheEvict란?

• 캐시를 삭제( 무효화 ) 한다.
• 데이터가 삭제되거나 변경될 때, 기존 캐시를 지워주는 용도로 사용한다.
• allEntries = true 옵션을 주면 해당 캐시 영역 전체를 비울 수도 있다.

핵심 키워드 : 캐시 정리

@CacheEvict(value = "books", key = "#id")
public void deleteBook(Long id) {
    log.info("DB 삭제 + 캐시 무효화 실행!");
    bookRepository.deleteById(id);
}

• 특정 ID에 대한 캐시만 제거 가능
• or 필요시 전체 캐시 날리기도 가능

---

4 . 👩🏻‍🏫 언제 어떤 어노테이션을 사용해야할까?

• @Cacheable -> 조회 성능 최적화 필요한 메서드 ( ex. 도서 상세 조회, 인기 글 목록 )
• @CachePut -> DB에 저장/수정 후 캐시까지 최신화가 필요한 메서드 ( ex. 게시글 수정, 사용자 프로필 변경 )
• @CacheEvict -> 데이터 삭제나 변경 시 낡은 캐시를 비워야하는 경우 ( ex. 게시글 삭제, 알림 삭제 )

---

5 . 마무리 🔚

Spring Cache는 단순해 보이지만,
올바른 캐시 전략을 세우지 않으면 오래된 데이터 제공이나 불필요한 캐시 메모리 낭비 문제가 생길 수 있다.
오늘 알아본 @Cachealbe, @CachePut, @CacheEvict의 역할과 상황을 잘 구분하여 사용한다면 조회 성능을 높이면서도 항상 최신 상태의 데이터를 보장하는 스마트한 캐싱 전략을 세울 수 있을 것이다 💯