bot 전체 코드 품질 개선 및 버그 수정

- GuildPlayer: 타이머 레이스 컨디션 수정, 모든 타이머 정리 로직 통합 (clearAllTimers)
- GuildPlayer: 이벤트 핸들러에 try-catch 추가 (end, exception, stuck)
- GuildPlayer: start 이벤트에서 endTimer 정리, autoPlay tracks 길이 검증 추가
- RedisClient: player_seek, player_volume에 누락된 return ���가
- RedisClient: queue_remove 인덱스 검증 주석 명확화
- Handler: runCommand에 try-catch 추가하여 에러 시 사용자에게 응답
- Channel: getGuildById에 누락된 await 추가, getMemberById/getVoiceChannelById 안전한 에러 처리
- Command.d.ts: 잘못된 타입 ChatInputChatInputCommandInteraction → ChatInputCommandInteraction 수정
- join.ts: 채널 멘션 닫는 괄호 누락 수정
- shuffle.ts: 제네릭 타입 적용, 불필요한 5회 반복 제거
- import 경로 대소문자 수정 (Shuffle → shuffle) - Linux 호환
- YoutubeMusic/Spotify: 하드코딩된 IP를 환경변수로 분리
- console.log/error → Logger 통일 (YoutubeMusic, Button, channel)
- interactionCreate: 전체 try-catch 추가, silent catch에 로깅 추가
- Database: schema 경로 __dirname 기반으로 수정, 컬럼 화이트리스트 추가
- 사용하지 않는 코드 정리 (axios 의존성, 주석처리된 user 관련 코드)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

bot/src/classes/GuildPlayer.ts

@@ -5,7 +5,7 @@ import { timeFormat } from "../utils/music/Utils";
 import { default_content, default_embed, default_image, getButtons } from "../utils/music/Config";
 import { GuildType } from "../../db/db";
 import { DB } from "../utils/Database";
-import { shuffle } from "../utils/Shuffle";
+import { shuffle } from "../utils/shuffle";
 import { checkTextChannelAndMsg } from "../utils/music/Channel";
 import { Logger } from "../utils/Logger";
 
@@ -22,6 +22,7 @@ export class GuildPlayer {
   public queue: QueueTrack[] = [];
   private errorTimer: NodeJS.Timeout | undefined;
   private endTimer: NodeJS.Timeout | undefined;
+  private closedTimer: NodeJS.Timeout | undefined;
 
   constructor(
     public guild: Guild,
@@ -32,45 +33,51 @@ export class GuildPlayer {
   ) {
     this.player.setGlobalVolume(50);
     this.player.on("start", (_data: TrackStartEvent) => {
+      // endTimer가 남아있으면 제거 (새 곡 재생 시작)
+      if (this.endTimer !== undefined) {
+        clearTimeout(this.endTimer);
+        this.endTimer = undefined;
+      }
       Redis?.publishState("player_update", {
         guildId: this.guild.id,
       });
     });
     this.player.on("end", async (data: TrackEndEvent) => {
-      if (this.isDead) return;
-      if (data.reason === "replaced") return;
-      // 방금 끝난 곡을 대기열에서 지우면서 lastPlayedTrack에 저장
-      this.lastPlayedTrack = this.queue.shift();
-      if (this.queue.length > 0) {
-        await this.playNext();
-      } else if (this.isRecommend && this.canRecommend) {
-        await this.autoPlay();
-      } else {
-        this.end();
+      try {
+        if (this.isDead) return;
+        if (data.reason === "replaced") return;
+        // 방금 끝난 곡을 대기열에서 지우면서 lastPlayedTrack에 저장
+        this.lastPlayedTrack = this.queue.shift();
+        if (this.queue.length > 0) {
+          await this.playNext();
+        } else if (this.isRecommend && this.canRecommend) {
+          await this.autoPlay();
+        } else {
+          this.end();
+        }
+      } catch (err) {
+        Logger.error(`[GuildPlayer] end 이벤트 <20><>리 중 에러: ${String(err)}`);
       }
     });
     this.player.on("closed", () => {
       if (this.isDead) return;
       Logger.info(`[GuildPlayer] 음성 연결이 끊어졌습니다. 재접속을 대기합니다...`);
-      setTimeout(() => {
+      // 이전 closed 타이머가 있으면 제거
+      if (this.closedTimer !== undefined) {
+        clearTimeout(this.closedTimer);
+      }
+      this.closedTimer = setTimeout(() => {
+        this.closedTimer = undefined;
         if (this.isDead) return;
         // 5초가 지났는데도 연결이 복구되지 않았을 때만 방을 나갑니다.
-        
+
         // 디스코드 방에 내 봇(me)이 없으면 봇을 삭제(delete)한다!
         if (!this.guild.members.me?.voice?.channelId) {
           Logger.warn(`[GuildPlayer] 음성채널에 봇이 없습니다. player를 초기화합니다.`);
           return this.delete();
         }
 
-        /**
-         * declare enum State {
-         *   CONNECTING = 0,
-         *   CONNECTED = 1,
-         *   DISCONNECTING = 2,
-         *   DISCONNECTED = 3
-         * }
-         */
-        // (1 = CONNECTED, Shoukaku 버전에 따라 연결 상태 체크가 다를 수 있으니 안전하게 확인)
+        // (1 = CONNECTED, Shoukaku 버전에 따라 연결 상태 체크가 다를 수 있으<EC9E88><EC9CBC> 안전하게 확인)
         if (this.player && this.player.node.state !== 1) {
           Logger.warn(`[GuildPlayer] 연결 복구 실패. 봇을 퇴장시킵니다.`);
           return this.delete();
@@ -79,12 +86,20 @@ export class GuildPlayer {
     });
 
     this.player.on("exception", async (data) => {
-      Logger.error(`[Lavalink] 재생 중 에러 발생: ${data.exception?.message}`);
-      await this.errMsg("유튜브 차단 또는 재생 오류로 인해 이 곡을 건너뜁니다.");
+      try {
+        Logger.error(`[Lavalink] 재생 중 에러 발생: ${data.exception?.message}`);
+        await this.errMsg("유튜브 차단 또는 재생 오류로 인해 이 곡을 건너뜁니다.");
+      } catch (err) {
+        Logger.error(`[GuildPlayer] exception 이벤트 처리 중 에러: ${String(err)}`);
+      }
     });
     this.player.on("stuck", async (data) => {
-      Logger.error(`[Lavalink] 곡 로딩 멈춤(Stuck) 발생: ${data.thresholdMs}ms 초과`);
-      await this.errMsg("음원 로딩이 멈췄습니다. 다음 곡으로 넘어갑니다.");
+      try {
+        Logger.error(`[Lavalink] 곡 로딩 멈춤(Stuck) 발생: ${data.thresholdMs}ms 초과`);
+        await this.errMsg("음원 로딩이 멈췄습니다. 다음 곡으로 넘어갑니다.");
+      } catch (err) {
+        Logger.error(`[GuildPlayer] stuck 이벤트 처리 중 에러: ${String(err)}`);
+      }
     });
   }
 
@@ -214,16 +229,31 @@ export class GuildPlayer {
       this.end();
       return;
     }
-    if (tracks[0].info.identifier === trackId) tracks = tracks.slice(1);
+    if (tracks.length > 0 && tracks[0].info.identifier === trackId) tracks = tracks.slice(1);
+    if (tracks.length === 0) {
+      this.end();
+      return;
+    }
     this.addTracks(tracks, "자동재생");
   }
 
-  public end() {
+  private clearAllTimers() {
     if (this.errorTimer !== undefined) {
       clearTimeout(this.errorTimer);
       this.errorTimer = undefined;
     }
-    if (this.endTimer !== undefined) clearTimeout(this.endTimer);
+    if (this.endTimer !== undefined) {
+      clearTimeout(this.endTimer);
+      this.endTimer = undefined;
+    }
+    if (this.closedTimer !== undefined) {
+      clearTimeout(this.closedTimer);
+      this.closedTimer = undefined;
+    }
+  }
+
+  public end() {
+    this.clearAllTimers();
     this.endTimer = setTimeout(() => {
       this.endTimer = undefined;
       this.delete(true);
@@ -238,7 +268,10 @@ export class GuildPlayer {
     if (this.isDead) return;
     if (!afterEnd) this.end();
     this.isDead = true;
-    this.player.destroy().catch(() => {});
+    this.clearAllTimers();
+    this.player.destroy().catch((err) => {
+      Logger.error(`[GuildPlayer] player.destroy 에러: ${String(err)}`);
+    });
     lavalinkManager.delPlayer(this.guild.id);
     lavalinkManager.shoukaku.leaveVoiceChannel(this.guild.id);
   }