Nest.js 프로젝트에 Redis 셋팅 추가하기

JSCODE 박재성

2026. 02. 13.

✅ Nest.js 프로젝트에 Redis 셋팅 추가하기

1. 라이브러리 설치하기

$ npm i @nestjs/cache-manager cache-manager cache-manager-ioredis
$ npm i -D @types/cache-manager @types/cache-manager-ioredis

2. AppModule 코드 수정하기
app.module.ts

import { BoardController } from './board.controller';
import { BoardService } from './board.service';
import { TypeOrmModule } from '@nestjs/typeorm';
import { Board } from './board.entity';
import { CacheModule } from '@nestjs/cache-manager';
import * as redisStore from 'cache-manager-ioredis';

@Module({
  imports: [
    TypeOrmModule.forRoot({
      type: 'mysql',
      host: 'localhost',
      port: 3306,
      username: 'root',
      password: 'password',
      database: 'mydb',
      autoLoadEntities: true,
      synchronize: true,
      logging: true,
    }),
    TypeOrmModule.forFeature([Board]),
    CacheModule.register({
      store: redisStore,
      host: 'localhost',
      port: 6379,
      ttl: 60,
    }),
  ],
  controllers: [BoardController],
  providers: [BoardService],
})
export class AppModule {}

3. BoardService 코드 수정하기
board.service.ts

import { Inject, Injectable } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Board } from './board.entity';
import { Repository } from 'typeorm';
import { CACHE_MANAGER, Cache } from '@nestjs/cache-manager';

@Injectable()
export class BoardService {
  constructor(
    @InjectRepository(Board)
    private boardRepository: Repository<Board>,
    @Inject(CACHE_MANAGER) 
    private cacheManager: Cache,
  ) {}

  async getBoards(page: number, size: number): Promise<Board[]> {
    const cacheKey = `boards:page:${page}:size:${size}`;
    const cachedData = await this.cacheManager.get<Board[]>(cacheKey);
    if (cachedData) {
      return cachedData;
    }

    const skip = (page - 1) * size;
    const boards = await this.boardRepository.find({
      order: {
        createdAt: 'desc',
      },
      skip: skip,
      take: size,
    });
    
    await this.cacheManager.set(cacheKey, boards);

    return boards;
  }
}

참고) Spring에서는 어노테이션만 가지고 처리할 수 있는 부분이 굉장히 많지만 Nest.js는 한계점이 존재한다. 이 때문에 캐싱에 대한 처리를 일일이 로직으로 짜주어야 하는 경우가 많다.

✅ 테스트 해보기

1. Nest.js 서버 실행시켜서 API 실행시켜보기

2. Redis-cli를 활용해 정상적으로 캐싱이 됐는 지 확인하기

$ redis-cli 

$ keys * # Redis에 저장되어 있는 모든 key 조회
$ get getBoards::boards:page:1:size:10 # 특정 key의 Value 조회
$ ttl getBoards::boards:page:1:size:10 # 특정 key의 TTL 조회