PostgreSQL 2201X 에러 방지를 위한 Pagination 입력 정규화 및 Keyset 전환 전략

Context

동적 쿼리 기반 Pagination 구현 시 사용자 입력값의 유효성 검증 부재로 인한 런타임 에러 발생. 특히 OFFSET 절에 음수, NULL, 또는 Non-Integer 타입이 전달될 때 시스템 안정성을 해치는 2201X 에러가 유발되는 구조적 한계 존재.

Technical Solution

• GREATEST 함수를 통한 Negative OFFSET 값의 0 하한선 강제 설정
• COALESCE 함수를 활용한 NULL 파라미터의 기본값 대체 및 런타임 타입 안정성 확보
• FLOOR 함수와 BIGINT 명시적 Cast를 통한 Floating-point 입력값의 정수화 처리
• 입력값 정규화 로직을 캡슐화한 safe_paginate PL/pgSQL 함수 설계를 통한 비즈니스 로직 보호
• 대규모 데이터셋의 성능 저하 및 에러 원천 차단을 위한 OFFSET 제거 및 Keyset Pagination 구조로의 전환