1. Cursor 기반 페이지네이션이란?

현재 페이지의 마지막 요소를 기준으로 다음 데이터를 가져오는 방식

• 페이지 번호(page=1, 2, 3...)를 사용하는 Offset 페이지네이션과 달리
• 특정 지점(cursor)을 기준으로 데이터의 “다음”을 불러오는 방식.

---

2. Offset(Page 번호) 기반

Offset 기반 페이징 (page=1,2,3)

예: LIMIT 10 OFFSET 30 (4번째 페이지)

문제점:

• 데이터가 중간에 삽입/삭제되면 페이지가 흔들림
• OFFSET이 커질수록 느림 (OFFSET 1000000 같은 경우 매우 비효율적)

---

Cursor 기반 페이징

예:cursor=100 → ID 100 이후의 10개를 가져와라

특징:

• 변경에 강함 (중간 데이터가 추가돼도 안정적)
• 빠름 (특정 ID 기준으로 Range Scan만 하면 됨)
• 트위터/인스타/유튜브 무한스크롤이 다 cursor 방식

---

3. Cursor 방식의 핵심 개념

✔ Cursor = "마지막 데이터의 고유 값"

보통 아래 중 하나를 cursor로 사용함:

• auto-increment PK (예: id)
• createdAt (정렬 기준)
• 복합키 (createdAt + id)

✔ 요청 시 두 값이 필요함

• size : 몇 개 가져올지
• cursor : 이어서 가져올 지점 (null이면 첫 페이지)

---

4. 동작 흐름

▷ 클라이언트가 첫 요청 보냄

GET /posts?size=10

서버 응답:

{
  "data": [...], // 10 items
  "nextCursor": 150
}

▷ 다음 요청

GET /posts?size=10&cursor=150

서버는 DB에서:

WHERE id < 150
ORDER BY id DESC
LIMIT 10;

이런 식으로 가져옴.

---

5. JPA + Querydsl로 cursor pagination 구현 예시

Post 엔티티 기준

① Repository Custom 정의

public interface PostRepositoryCustom {
    Slice<Post> findByCursor(Long cursor, int size);
}

② 구현체

@RequiredArgsConstructor
public class PostRepositoryImpl implements PostRepositoryCustom {

    private final JPAQueryFactory query;

    @Override
    public Slice<Post> findByCursor(Long cursor, int size) {

        QPost post = QPost.post;

        List<Post> result = query
            .selectFrom(post)
            .where(
                cursor != null ? post.id.lt(cursor) : null
            )
            .orderBy(post.id.desc())
            .limit(size + 1) // 다음 페이지 존재 여부 확인
            .fetch();

        boolean hasNext = result.size() > size;

        if (hasNext) {
            result.remove(size);
        }

        return new SliceImpl<>(result, PageRequest.of(0, size), hasNext);
    }
}

cursor 방식에서 limit(size + 1) 로 다음 페이지 존재 여부를 판단.
만약, 다음 페이지가 있으면 result.size() > size

---

6. API 응답 형태 예시

{
  "posts": [...10개...],
  "nextCursor": 123,
  "hasNext": true
}

---

7. Cursor 페이징이 좋은 이유

✔ 안정적

새 글이 추가되어도 결과 순서가 흔들리지 않음.

✔ 매우 빠름

WHERE id < 150
정렬 + Range Scan만 하면 되어 OFFSET 1000000 보다 수십~수백배 빠름

✔ 무한 스크롤에 최적화

NextCursor만 보내면 되니까.

---

Cursor 방식이 불리한 경우

• 페이지 번호 기반 UI가 필요할 때 (예: 3페이지로 바로 이동)
• 정렬 조건이 여러 개일 때 (PK 외에도, 복합 정렬이 많으면 구현 복잡해짐)

---

8. 비교

방식	장점	단점
Offset(page)	구현 쉬움, 페이지 번호 접근 가능	느림, 데이터 변경에 취약
Cursor	빠르고 안정적, SNS에 최적	페이지 번호 이동 불가, 복합정렬 어려움