MyBatis 성능 최적화 — 캐시, 배치, N+1 해결 전략

// 같은 SqlSession 내에서 동일 쿼리는 캐시 히트
try (SqlSession session = sqlSessionFactory.openSession()) {
    UserMapper mapper = session.getMapper(UserMapper.class);

    User first = mapper.findById(1L);   // DB 조회
    User second = mapper.findById(1L);  // 캐시 반환 (SQL 실행 안 함)

    // first == second (같은 객체 참조)
}

<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">

  <!-- 2차 캐시 활성화 -->
  <cache
    eviction="LRU"
    flushInterval="60000"
    size="512"
    readOnly="true"/>

  <select id="findById" resultType="User">
    SELECT * FROM users WHERE id = #{id}
  </select>

</mapper>

// 2차 캐시 대상 DTO — Serializable 필수
public class User implements Serializable {
    private static final long serialVersionUID = 1L;
    private Long id;
    private String name;
    private String email;
}

// Batch 모드로 SqlSession 열기
try (SqlSession session = sqlSessionFactory.openSession(ExecutorType.BATCH)) {
    UserMapper mapper = session.getMapper(UserMapper.class);

    for (int i = 0; i < 10000; i++) {
        mapper.insert(new User("user" + i, "user" + i + "@example.com"));

        // 500건마다 flush하여 메모리 부담 줄이기
        if (i % 500 == 0) {
            session.flushStatements();
        }
    }

    session.flushStatements(); // 남은 배치 실행
    session.commit();          // 커밋
}

@Configuration
public class MyBatisBatchConfig {

    @Bean
    public SqlSessionTemplate batchSqlSessionTemplate(SqlSessionFactory factory) {
        // BATCH 모드 전용 SqlSessionTemplate 생성
        return new SqlSessionTemplate(factory, ExecutorType.BATCH);
    }
}

@Service
@RequiredArgsConstructor
public class UserBatchService {

    private final SqlSessionTemplate batchSqlSessionTemplate;

    @Transactional
    public void batchInsert(List<User> users) {
        UserMapper mapper = batchSqlSessionTemplate.getMapper(UserMapper.class);

        for (int i = 0; i < users.size(); i++) {
            mapper.insert(users.get(i));

            // 주기적으로 flush
            if (i % 500 == 0) {
                batchSqlSessionTemplate.flushStatements();
            }
        }
        batchSqlSessionTemplate.flushStatements();
    }
}

<!-- 한 번의 INSERT로 여러 행 삽입 -->
<insert id="batchInsert" parameterType="list">
  INSERT INTO users (name, email) VALUES
  <foreach collection="list" item="user" separator=",">
    (#{user.name}, #{user.email})
  </foreach>
</insert>

<!-- 주문 목록 조회 — 1번의 쿼리 -->
<select id="findAllOrders" resultMap="orderResultMap">
  SELECT * FROM orders
</select>

<!-- 각 주문의 상품 조회 — N번의 추가 쿼리 -->
<resultMap id="orderResultMap" type="Order">
  <id property="id" column="id"/>
  <collection property="items" column="id"
              select="findItemsByOrderId"/>
</resultMap>

<select id="findItemsByOrderId" resultType="OrderItem">
  SELECT * FROM order_items WHERE order_id = #{orderId}
</select>

<!-- Join으로 한 번에 조회 -->
<select id="findAllOrdersWithItems" resultMap="orderWithItemsMap">
  SELECT o.id as order_id, o.total_amount,
         i.id as item_id, i.product_name, i.quantity
  FROM orders o
  LEFT JOIN order_items i ON o.id = i.order_id
</select>

<resultMap id="orderWithItemsMap" type="Order">
  <id property="id" column="order_id"/>
  <result property="totalAmount" column="total_amount"/>
  <collection property="items" ofType="OrderItem">
    <id property="id" column="item_id"/>
    <result property="productName" column="product_name"/>
    <result property="quantity" column="quantity"/>
  </collection>
</resultMap>

<!-- fetchType="lazy"로 지연 로딩 -->
<collection property="items" column="id"
            select="findItemsByOrderId"
            fetchType="lazy"/>

# application.yml
mybatis:
  configuration:
    lazy-loading-enabled: true           # 지연 로딩 활성화
    aggressive-lazy-loading: false       # false여야 개별 필드 접근 시 로딩

<!-- 글로벌 설정과 무관하게 이 매핑만 lazy -->
<association property="author" column="author_id"
             select="findAuthorById"
             fetchType="lazy"/>

<!-- 이 매핑은 즉시 로딩 -->
<collection property="comments" column="post_id"
            select="findCommentsByPostId"
            fetchType="eager"/>

<!-- 대량 조회 시 fetchSize를 크게 설정 -->
<select id="findAllUsers" resultType="User" fetchSize="1000">
  SELECT * FROM users
</select>

# 글로벌 fetchSize 설정
mybatis:
  configuration:
    default-fetch-size: 100

<!-- 나쁜 예 — 모든 컬럼 조회 -->
<select id="findUsers" resultType="User">
  SELECT * FROM users
</select>

<!-- 좋은 예 — 필요한 컬럼만 조회 -->
<select id="findUsers" resultType="User">
  SELECT id, name, email FROM users
</select>

<!-- 공통 컬럼 목록 정의 -->
<sql id="userColumns">
  id, name, email, created_at
</sql>

<select id="findById" resultType="User">
  SELECT <include refid="userColumns"/>
  FROM users WHERE id = #{id}
</select>

<select id="findByEmail" resultType="User">
  SELECT <include refid="userColumns"/>
  FROM users WHERE email = #{email}
</select>

<!-- 이 쿼리는 항상 최신 데이터가 필요 — 캐시 사용 안 함 -->
<select id="findCurrentBalance" resultType="BigDecimal"
        useCache="false" flushCache="true">
  SELECT balance FROM accounts WHERE id = #{id}
</select>

# SQL 로그 활성화 — 개발 환경에서 필수
logging:
  level:
    com.example.mapper: DEBUG    # Mapper 패키지의 SQL 로그
    org.mybatis: DEBUG           # MyBatis 내부 동작 로그