[Spring Boot + MyBatis] SqlSessionFactory 오류부터 resultMap 적용까지

1. 개요

Spring Boot와 MyBatis를 연동할 때 가장 흔히 마주치는 설정 오류 중 하나인 SqlSessionFactory 생성 실패 이슈를 어떻게 해결했는지,

그리고 resultMap을 언제 꼭 써야 하는지도 실제 사례 기반으로 정리

 

2. 문제 발생 : SqlSessionFactory 초기화 실패

❌ 에러 메시지

---

Failed to parse config resource: class path resource [sql-map-config.xml]

---

🔍 원인 분석

• sql-map-config.xml 파일이 실제로 존재하지 않거나,

• application.yml에서 잘못된 경로를 지정했거나,

• 혹은 xml 내부 문법 오류 (예: 태그 누락, 오타 등)

 

✅ 해결 방법

• sql-map-config.xml이 정말 존재하는지 resources/ 하위 확인

• 문법 오류가 없는지 IDE에서 확인 (<configuration>, <mappers> 등)

• 굳이 설정 파일이 필요 없다면 application.yml에서 설정 제거

---

# 필요 없으면 이거 제거
mybatis:
  config-location: classpath:sql-map-config.xml

---

✅ 본 프로젝트 오류 원인

---

→ .xml 에서 설정한 resource = ".xml파일" 의 이름과 실제 저장된 파일의 이름이 다름 (실제 파일은 _를 사용 .xml에서는 - 를 사용하여 파일을 찾지 못함

---

3. resultType만으로 충분한가? resultMap 꼭 써야 하나?

🤔 의문

Spring Boot + MyBatis에서 resultType으로도 자동 매핑이 되는데 굳이 resultMap을 써야 하나?

 

✅ 결론

 

컬럼명과 VO 필드명이 정확히 일치하면 resultType만으로도 충분

다만 아래 조건에선 resultMap이 필요

 

4. resultMap이 꼭 필요한 상황

✔ 계산 컬럼이 포함된 경우 (VO에만 있고 DB에는 없는 필드)

---

SELECT MEMBER_ID, (SELECT COUNT(*) FROM PURCHASE WHERE MEMBER_ID = M.MEMBER_ID) AS PURCHASE_COUNT
FROM MEMBER M

→ PURCHASE_COUNT는 DB 테이블 컬럼이 아니라서, VO에만 있는 purchaseCount와 자동 매핑되지 않음

---

✔ 조인 결과가 포함될 때

---

SELECT REVIEW.*, MEMBER.MEMBER_NAME, MEMBER.IS_WITHDRAW
FROM REVIEW JOIN MEMBER ON REVIEW.MEMBER_ID = MEMBER.MEMBER_ID

→ memberName, memberIsWithdraw 등은 JOIN으로 가져온 외부 컬럼이라 resultMap 필수

---

5. 예시 코드

✅ resultType으로 충분한 경우

---

<select id="SELECTALL" resultType="member">
  SELECT MEMBER_NUMBER, MEMBER_ID, MEMBER_NAME FROM MEMBER
</select>

---

✅ resultMap을 반드시 써야 하는 경우

---

<resultMap id="memberMap" type="MemberVO">
  <id property="memberNumber" column="MEMBER_NUMBER"/>
  <result property="memberId" column="MEMBER_ID"/>
  <result property="purchaseCount" column="PURCHASE_COUNT"/>
</resultMap>

<select id="SELECTWITHCOUNT" resultMap="memberMap">
  SELECT M.MEMBER_NUMBER, M.MEMBER_ID,
         (SELECT COUNT(*) FROM PURCHASE WHERE MEMBER_NUMBER = M.MEMBER_NUMBER) AS PURCHASE_COUNT
  FROM MEMBER M
</select>

---

✅ 본 프로젝트 오류 원인

---

→ 오라클 11g 버전을 사용하면서 발생한 별칭 길이 제한으로 인해,

기존에 사용하던 컬럼명 PRODUCT_COMBO_DISCOUNTED_PRICE에서 COMBO_DISCOUNTED_PRICE로 변경함

→ MyBatis가 자동 매핑에 실패하여 행(row) 자체를 null로 반환하여 모든 데이터가 null로 반환

→ List 자체가 null이어서 데이터 추출 실패

→ resultMap을 사용하여 property = "VO에서 사용하는 멤버변수" / column = "SQL문에서 사용하는 컬럼명"을 1:1로 매핑해주어 데이터 추출 

---

6. 마무리

이번 실전 트러블슈팅을 통해,

• MyBatis 설정 에러(SqlSessionFactory)의 원인과 대처법

• resultType과 resultMap의 적용 기준을 명확히 정리 가능