[실습] 많이 검색한 키워드 Top 10을 보여주는 '인기 검색어 기능’ 만들기 - 1

JSCODE 박재성

2026-01-12

✅ 인기 검색어 기능 구현

✅ 실습 진행하기

효율적인 실습을 위해 검색 API, 인기 검색어 Top 10 조회 API를 미리 만들어뒀다.

1. 검색 API, 인기 검색어 조회 API 살펴보기
SearchKeyword

@Entity(name = "search_keywords")
@Getter
@NoArgsConstructor
public class SearchKeyword {

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

    @Column(unique = true)
    private String keyword;

    private Long count;

    public SearchKeyword(String keyword) {
        this.keyword = keyword;
        this.count = 1L;
    }

    public void increaseCount() {
        this.count++;
    }
}

 
SearchController

@RestController
@RequiredArgsConstructor
@RequestMapping("/search")
public class SearchController {

    private final SearchService searchService;

    @GetMapping()
    public void search(@RequestParam String keyword) {
        searchService.search(keyword);
    }

    @GetMapping("/top10")
    public List<String> getTop10Keywords() {
        return searchService.getTop10Keywords();
    }
}

 
StockService

@Service
@RequiredArgsConstructor
public class SearchService {

    private final SearchRepository searchRepository;

    @Transactional
    public void search(String keyword) {
        SearchKeyword searchKeyword = searchRepository.findByKeyword(keyword)
                .orElse(new SearchKeyword(keyword));
        searchKeyword.increaseCount();
        searchRepository.save(searchKeyword);
    }

    @Transactional(readOnly = true)
    public List<String> getTop10Keywords() {
        return searchRepository.findTop10ByOrderByCountDesc().stream()
                .map(SearchKeyword::getKeyword)
                .toList();
    }
}

 
StockRepository

public interface SearchRepository extends JpaRepository<SearchKeyword, Long> {
    Optional<SearchKeyword> findByKeyword(String word);
    List<SearchKeyword> findTop10ByOrderByCountDesc();
}

 

3. Spring Boot 실행시키기



 

2. 부하 테스트 스크립트 살펴보기
scripts/script_3-1.js

import http from 'k6/http';
import {check} from 'k6';
import {randomItem} from 'https://jslib.k6.io/k6-utils/1.2.0/index.js';

export const options = {
  // 가상 유저(VUs) 100명으로 설정
  vus: 100,

  // 테스트를 10초 동안 진행
  duration: '10s',
};

// 검색어 리스트 정의
const keywords = [
  'spring', 'java', 'redis', 'mysql', 'jpa',
  'k6', 'performance', 'test', 'load', 'stress',
  'docker', 'kubernetes', 'aws', 'cloud', 'microservices',
  'python', 'javascript', 'react', 'vue', 'angular'
];

export default function () {
  // 1. 검색 API 호출
  // 랜덤한 키워드 선택
  const keyword = randomItem(keywords);
  
  // 검색 요청
  const searchRes = http.get(`http://localhost:8080/search?keyword=${keyword}`);
  
  check(searchRes, {
    'search status is 200': (r) => r.status === 200,
  });

  // 2. 인기 검색어 조회 API 호출
  const top10Res = http.get('http://localhost:8080/search/top10');
  
  check(top10Res, {
    'top10 status is 200': (r) => r.status === 200,
  });
}

 

4. 부하 테스트 진행하기

$ k6 run scripts/script_3-1.js



검색 API와 인기 검색어 조회 API 둘 다 총 합해서 1346번 요청을 보냈음을 알 수 있고, 두 API 평균 TPS는 123인 것을 알 수 있다.
RDB를 기반으로 인기 검색어 Top 10을 조회하려면 count(검색 횟수)를 기준으로 매번 정렬을 해서 조회해야 하기 때문에 성능 측면에서 비효율이 발생한다. 따라서 성능을 개선하기 위해 RDB 대신에 Redis를 활용해 구현해보자.
참고) RDB의 인덱스를 활용해서 성능을 개선하는 것도 하나의 방법이지만, 여기서는 극도로 성능을 끌어올려야 한다는 가정하에 Redis를 도입하는 상황이라고 가정하자.