1. 배경 (Background)

• 스뮤클럽은 동아리를 관리 할 수 있는 플랫폼입니다.
• 동아리장은 운영중인 동아리 중, 동아리 관리 버튼으로 게시글을 수정할 수 있습니다.

• 동아리 관리(수정)을 하고싶을 땐 “동아리 테이블”, “동아리 이미지 테이블”을 함께 가져와야합니다.
• 이미지 테이블은 동아리 테이블과 양방향 매핑 관계를 갖습니다. (N:1, 1:N)

**@Query("SELECT c FROM Club c JOIN FETCH c.clubImages WHERE c.id = :clubId")
    Optional<Club> findByIdWithClubImages(Long clubId);**

• 클럽 상세 조회를 구현할 때, Club 엔티티 조회 시 연관된 ClubImage 리스트를 한 번에 가져오기 위해 Fetch Join을 적용했습니다.
• 왜냐하면 Club과 ClubImage를 조인하여 쿼리 한 번으로 데이터를 조회하고자 했기 때문입니다.
• 만약 findById 를 사용했다면, N+1 문제가 일어났을 것입니다.

2. 문제 상황 (Problem)

• 현상:

  • DB에는 분명히 **id=1**인 클럽 데이터가 존재합니다.
  • 그러나 findByIdWithClubImages(1L) 호출 시 **Optional.empty()**가 반환되었습니다.
  • 결과적으로 C**lubNotFoundException: clubId: 1 를 찾지 못했습니다.** 라는 예외가 발생했습니다.

• 에러 로그:

  2025-12-21T17:12:14.754+09:00  WARN 27653 
  --- [smu-club] [nio-8080-exec-7] .m.m.a.ExceptionHandlerExceptionResolver : 
  Resolved [com.example.smu_club.exception.custom.ClubNotFoundException: 
  clubId: 1 를 찾지 못했습니다.]
  

3. 원인 분석 (Root Cause)