refactor: ConstraintViolationException 파싱 로직 유틸로 통합

3곳에 중복된 예외 체인 탐색 로직을 ConstraintViolationUtils.isViolation()으로 추출.
버그 수정 시 한 곳만 고치면 되고, 제약 조건 이름 변경에도 누락 없이 대응 가능.

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

Author: pooreumjung

src/main/java/com/semosan/api/common/exception/ConstraintViolationUtils.java

@@ -0,0 +1,29 @@
+package com.semosan.api.common.exception;
+
+import org.hibernate.exception.ConstraintViolationException;
+
+public final class ConstraintViolationUtils {
+
+    private ConstraintViolationUtils() {}
+
+    /**
+     * 예외 체인 전체를 탐색해 특정 DB 제약 조건 이름이 원인인지 확인한다.
+     * Hibernate ConstraintViolationException의 constraintName과 메시지 문자열을 모두 검사해
+     * 드라이버마다 다른 예외 래핑 방식에 대응한다.
+     */
+    public static boolean isViolation(Throwable exception, String constraintName) {
+        Throwable current = exception;
+        while (current != null) {
+            if (current instanceof ConstraintViolationException constraintViolation
+                    && constraintName.equals(constraintViolation.getConstraintName())) {
+                return true;
+            }
+            String message = current.getMessage();
+            if (message != null && message.contains(constraintName)) {
+                return true;
+            }
+            current = current.getCause();
+        }
+        return false;
+    }
+}

src/main/java/com/semosan/api/domain/hiking/service/HikingRecordService.java

@@ -19,10 +19,10 @@
 import com.semosan.api.domain.tracking.repository.TrackingPhotoRepository;
 import com.semosan.api.domain.tracking.repository.TrackingPointRepository;
 import com.semosan.api.domain.tracking.repository.projection.TrackingPathProjection;
+import com.semosan.api.common.exception.ConstraintViolationUtils;
 import com.semosan.api.domain.user.entity.User;
 import com.semosan.api.domain.user.service.UserReader;
 import lombok.RequiredArgsConstructor;
-import org.hibernate.exception.ConstraintViolationException;
 import org.springframework.dao.DataIntegrityViolationException;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
@@ -147,26 +147,11 @@ public CourseDifficultyFeedbackResponse createCourseDifficultyFeedback(
         try {
             return CourseDifficultyFeedbackResponse.from(courseDifficultyFeedbackRepository.saveAndFlush(feedback));
         } catch (DataIntegrityViolationException e) {
-            if (isDifficultyFeedbackHikingRecordUniqueViolation(e)) {
+            // 동시 요청으로 유니크 제약 위반 시 이미 피드백이 존재하는 에러로 변환
+            if (ConstraintViolationUtils.isViolation(e, DIFFICULTY_FEEDBACK_HIKING_RECORD_UNIQUE_CONSTRAINT)) {
                 throw new GeneralException(ErrorStatus.COURSE_DIFFICULTY_FEEDBACK_ALREADY_EXISTS);
             }
             throw e;
         }
     }
-
-    private boolean isDifficultyFeedbackHikingRecordUniqueViolation(Throwable exception) {
-        Throwable current = exception;
-        while (current != null) {
-            if (current instanceof ConstraintViolationException constraintViolation
-                    && DIFFICULTY_FEEDBACK_HIKING_RECORD_UNIQUE_CONSTRAINT.equals(constraintViolation.getConstraintName())) {
-                return true;
-            }
-            String message = current.getMessage();
-            if (message != null && message.contains(DIFFICULTY_FEEDBACK_HIKING_RECORD_UNIQUE_CONSTRAINT)) {
-                return true;
-            }
-            current = current.getCause();
-        }
-        return false;
-    }
 }

src/main/java/com/semosan/api/domain/tracking/service/TrackingSessionService.java

@@ -16,11 +16,11 @@
 import com.semosan.api.domain.tracking.enums.TrackingSessionStatus;
 import com.semosan.api.domain.tracking.event.TrackingSessionTerminatedEvent;
 import com.semosan.api.domain.tracking.repository.TrackingSessionRepository;
+import com.semosan.api.common.exception.ConstraintViolationUtils;
 import com.semosan.api.domain.user.entity.User;
 import com.semosan.api.domain.user.service.UserReader;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
-import org.hibernate.exception.ConstraintViolationException;
 import org.springframework.context.ApplicationEventPublisher;
 import org.springframework.dao.DataIntegrityViolationException;
 import org.springframework.stereotype.Service;
@@ -178,26 +178,11 @@ private TrackingSession saveSession(TrackingSession session) {
         try {
             return trackingSessionRepository.save(session);
         } catch (DataIntegrityViolationException e) {
-            if (isActiveSessionUniqueViolation(e)) {
+            // 동시 요청으로 유니크 제약 위반 시 이미 진행 중인 세션 존재 에러로 변환
+            if (ConstraintViolationUtils.isViolation(e, ACTIVE_SESSION_UNIQUE_INDEX)) {
                 throw new GeneralException(ErrorStatus.TRACKING_SESSION_ALREADY_IN_PROGRESS);
             }
             throw e;
         }
     }
-
-    private boolean isActiveSessionUniqueViolation(Throwable exception) {
-        Throwable current = exception;
-        while (current != null) {
-            if (current instanceof ConstraintViolationException constraintViolation
-                    && ACTIVE_SESSION_UNIQUE_INDEX.equals(constraintViolation.getConstraintName())) {
-                return true;
-            }
-            String message = current.getMessage();
-            if (message != null && message.contains(ACTIVE_SESSION_UNIQUE_INDEX)) {
-                return true;
-            }
-            current = current.getCause();
-        }
-        return false;
-    }
 }

src/main/java/com/semosan/api/domain/user/service/UserBlockService.java

@@ -1,5 +1,6 @@
 package com.semosan.api.domain.user.service;
 
+import com.semosan.api.common.exception.ConstraintViolationUtils;
 import com.semosan.api.common.exception.GeneralException;
 import com.semosan.api.common.status.ErrorStatus;
 import com.semosan.api.domain.community.post.entity.FreePost;
@@ -9,7 +10,6 @@
 import com.semosan.api.domain.user.repository.UserBlockRepository;
 import com.semosan.api.domain.user.repository.UserRepository;
 import lombok.RequiredArgsConstructor;
-import org.hibernate.exception.ConstraintViolationException;
 import org.springframework.dao.DataIntegrityViolationException;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
@@ -40,7 +40,8 @@ public void block(Long blockerId, Long blockedUserId) {
         try {
             userBlockRepository.saveAndFlush(UserBlock.create(blocker, blockedUser));
         } catch (DataIntegrityViolationException e) {
-            if (!isUniqueViolation(e)) {
+            // 동시 요청으로 유니크 제약 위반 시 멱등 처리 (이미 차단된 상태로 간주)
+            if (!ConstraintViolationUtils.isViolation(e, BLOCK_UNIQUE_CONSTRAINT)) {
                 throw e;
             }
         }
@@ -53,22 +54,6 @@ public void blockByPost(Long blockerId, Long postId) {
         block(blockerId, post.getAuthor().getId());
     }
 
-    private boolean isUniqueViolation(Throwable exception) {
-        Throwable current = exception;
-        while (current != null) {
-            if (current instanceof ConstraintViolationException constraintViolation
-                    && BLOCK_UNIQUE_CONSTRAINT.equals(constraintViolation.getConstraintName())) {
-                return true;
-            }
-            String message = current.getMessage();
-            if (message != null && message.contains(BLOCK_UNIQUE_CONSTRAINT)) {
-                return true;
-            }
-            current = current.getCause();
-        }
-        return false;
-    }
-
     private User findActiveUserOrThrow(Long userId) {
         return userRepository.findByIdAndDeletedFalse(userId)
                 .orElseThrow(() -> new GeneralException(ErrorStatus.USER_NOT_FOUND));