문제 인식

Docker Container 환경에서 게임 서버 실행 시, Bull Queue 작업 추가에 문제가 발생했습니다.

🚫 문제점

• node.js 로컬 환경에서 Bull Queue 작업 확인 후 Container에 올린 후 Bull Queue 작업 불가

원인 파악

게임 서버 Bull Queue 작업 로그

• MaxRetriesPerRequestError : Redis 클라이언트에서 발생하는 에러
  • 요청이 일정 횟수 이상 재시도되었음에도 불구하고 성공하지 못할 때 발생
  • 주로 Redis 서버에 접근할 수 없는 경우나 네트워크 연결 문제로 인해 발생

🔍 분석

• docker image를 생성 후 docker-compose up을 실행해서 던전 입장 대기열 접속 시, MaxRetriesPerRequestError **오류 발생
• matchEnqueue called 이후에 로그가 찍히지 않고 에러가 발생하는 것을 확인

해결 과정

Redis Client 변경

// 기존 코드
import redis from 'redis';

const redisClient = redis.createClient({
   url: `redis://${config.redis.redisUsername}:${config.redis.redisPassword}@${config.redis.redisHost}:${config.redis.redisPort}/0`,
 });

// 변경 코드
import Redis from 'ioredis';

const redisClient = new Redis({
  port: config.redis.redisPort,
  host: config.redis.redisHost,
  username: config.redis.redisUsername,
  password: config.redis.redisPassword,
  db: 0,
  maxRetriesPerRequest: null,
  enableReadyCheck: true,
});

• ioredis에서는 특정 요청이 실패할 때 재시도할 최대 횟수를 설정할 가능하고, 이 설정이 초과되면 MaxRetriesPerRequestError가 발생
• 현재 node-redis 라이브러리를 사용하고 있어 MaxRetriesPerRequestError와 같은 옵션 미적용
• Redis 클라이언트를 node-redis에서 ioredis로 변경 후 maxRetriesPerRequest 옵션 설정

Bull Queue 생성 시 Redis Client 전달 로직 수정

const monsterHitQueue = new Bull('MONSTER_HIT_QUEUE_NAME', {
  redis: {
    host: config.redis.redisHost,
    port: config.redis.redisPort,
  },
});