Next.js 15 기반 Supabase 세션 최적화 및 Stripe 결제 동기화 설계

Context

단일 Supabase 클라이언트 사용으로 인한 권한 충돌 및 세션 관리의 한계 발생. 특히 Webhook 처리 시 RLS 제약으로 인한 데이터 쓰기 실패와 Token 만료 시 사용자 강제 로그아웃 문제가 주요 병목 지점으로 식별됨.

Technical Solution

• Context별 최적화된 3종 Supabase Client 분리 설계로 Browser(Client Component), Server(API/Server Component), Service(Webhook/Admin) 간 역할 명확화
• Middleware 내 supabase.auth.getUser() 호출을 통한 Access Token 자동 갱신 및 Response Cookie 업데이트 로직 구현
• service_role 키를 활용한 Service Client 도입으로 Webhook 처리 시 RLS(Row Level Security)를 완전히 우회하여 데이터 무결성 확보
• security definer 트리거 기반의 Profile 자동 생성 구조를 통해 신규 가입자의 RLS 권한 부족으로 인한 Insert 실패 문제 해결
• Stripe Webhook 핸들러에 Upsert 패턴을 적용하여 네트워크 재시도 상황에서도 데이터 일관성을 유지하는 Idempotency 보장