From 9f4a5ef37aa59f9380bbe38ee8b5bcd9f40187e6 Mon Sep 17 00:00:00 2001
From: DanielLee <198891672+sanghyeonhd@users.noreply.github.com>
Date: Mon, 8 Dec 2025 11:28:37 +0900
Subject: [PATCH] Cache Reset Failed Error Fix

---
 .../code/config/CommonCodeCacheManager.java   | 47 ++++++++++++++-----
 1 file changed, 35 insertions(+), 12 deletions(-)

diff --git a/src/main/java/com/kamco/cd/kamcoback/code/config/CommonCodeCacheManager.java b/src/main/java/com/kamco/cd/kamcoback/code/config/CommonCodeCacheManager.java
index 7231bbd3..fcd51d9b 100644
--- a/src/main/java/com/kamco/cd/kamcoback/code/config/CommonCodeCacheManager.java
+++ b/src/main/java/com/kamco/cd/kamcoback/code/config/CommonCodeCacheManager.java
@@ -14,6 +14,7 @@ import org.springframework.stereotype.Component;
  * 공통코드 캐시 관리 및 초기화 클래스
  *
  * <p>애플리케이션 시작 시 공통코드를 Redis 캐시에 미리 로드하고, 캐시 갱신을 관리합니다.
+ * 기존 Redis 데이터와의 호환성 문제로 인한 간헐적 오류를 방지합니다.
  */
 @Slf4j
 @Component
@@ -29,27 +30,45 @@ public class CommonCodeCacheManager {
    * 애플리케이션 시작 완료 후 공통코드를 Redis 캐시에 미리 로드
    *
    * <p>이 메서드는 Spring 애플리케이션이 완전히 시작된 후에 자동으로 실행되며, 공통코드 데이터를 Redis
-   * 캐시에 미리 로드하여 초기 조회 시 성능을 최적화합니다.
+   * 캐시에 미리 로드하여 초기 조회 시 성능을 최적화합니다. 기존 캐시 데이터 호환성 문제를 대비하여 먼저
+   * 캐시를 초기화한 후 재로드합니다.
    */
   @EventListener(ApplicationReadyEvent.class)
   public void initializeCommonCodeCache() {
     try {
       log.info("=== 공통코드 캐시 초기화 시작 ===");
 
-      List<Basic> allCommonCodes = commonCodeService.getFindAll();
+      // 1. 기존 캐시 데이터 호환성 문제 방지: 먼저 캐시 전체 초기화
+      try {
+        clearCommonCodeCache();
+        log.debug("✓ 기존 캐시 데이터 정리 완료 (호환성 문제 방지)");
+      } catch (Exception clearEx) {
+        log.debug("기존 캐시 초기화 중 예외 (무시됨): {}", clearEx.getMessage());
+      }
 
-      log.info("✓ 공통코드 {}개가 Redis 캐시에 로드되었습니다.", allCommonCodes.size());
-      allCommonCodes.forEach(
+      // 2. DB에서 새로운 데이터 로드 (캐시 미스 상태)
+      List<Basic> allCommonCodes = commonCodeService.getFindAll();
+      log.info(
+        "✓ 공통코드 {}개를 DB에서 로드하고 Redis 캐시에 저장했습니다.",
+        allCommonCodes.size());
+
+      // 3. 로그 출력 (DEBUG 레벨)
+      if (log.isDebugEnabled()) {
+        allCommonCodes.forEach(
           code ->
-              log.debug(
-                  "  - [{}] {} (ID: {})",
-                  code.getCode(),
-                  code.getName(),
-                  code.getId()));
+            log.debug(
+              "  - [{}] {} (ID: {})",
+              code.getCode(),
+              code.getName(),
+              code.getId()));
+      }
 
       log.info("=== 공통코드 캐시 초기화 완료 ===");
     } catch (Exception e) {
-      log.error("공통코드 캐시 초기화 중 오류 발생", e);
+      log.warn(
+        "공통코드 캐시 초기화 중 오류 발생했습니다. 캐시 없이 계속 진행합니다. "
+          + "(첫 번째 조회 시 DB에서 로드되고 캐시됩니다.)",
+        e);
     }
   }
 
@@ -71,6 +90,7 @@ public class CommonCodeCacheManager {
       log.info("✓ 공통코드 캐시가 {}개 항목으로 갱신되었습니다.", allCommonCodes.size());
     } catch (Exception e) {
       log.error("공통코드 캐시 갱신 중 오류 발생", e);
+      throw new RuntimeException("공통코드 캐시 갱신 실패", e);
     }
   }
 
@@ -87,13 +107,16 @@ public class CommonCodeCacheManager {
         log.info("✓ 공통코드 캐시가 초기화되었습니다.");
       }
     } catch (Exception e) {
-      log.error("공통코드 캐시 초기화 중 오류 발생", e);
+      log.warn("공통코드 캐시 초기화 중 예외 발생 (무시됨): {}", e.getMessage());
+      // 무시하고 계속 진행 - 캐시 초기화 실패가 시스템 전체를 중단시키지 않도록
     }
   }
 
   /**
    * 캐시 상태 확인
    *
+   * <p>현재 Redis 캐시에 저장된 공통코드의 개수를 반환합니다. 캐시 미스 상태인 경우 DB에서 새로 로드합니다.
+   *
    * @return 캐시에 있는 공통코드 개수
    */
   public int getCachedCommonCodeCount() {
@@ -101,7 +124,7 @@ public class CommonCodeCacheManager {
       List<Basic> cachedCodes = commonCodeService.getFindAll();
       return cachedCodes.size();
     } catch (Exception e) {
-      log.warn("캐시 상태 확인 중 오류 발생", e);
+      log.warn("캐시 상태 확인 중 오류 발생: {}", e.getMessage());
       return 0;
     }
   }