Supabase
Supabase 문제를 확인할 때는 데이터베이스 요청, Auth 요청, Storage 요청을 분리하고 프로젝트 설정·브라우저 요청·서버 로그를 같은 시각 기준으로 비교해야 합니다.
플랫폼 정의
Supabase는 PostgreSQL 데이터베이스를 중심으로 Auth와 Storage 같은 기능을 애플리케이션에서 사용할 수 있게 제공하는 플랫폼입니다. 화면에서 같은 오류가 보여도 데이터베이스 권한, 로그인 상태, 저장소 정책은 서로 다른 확인 범위를 가집니다.
문제를 나누는 기준
- 데이터베이스 요청의 URL, 상태 코드와 응답 본문을 기록합니다.
- Auth 요청인지 Storage 요청인지 브라우저 Network에서 확인합니다.
- 프로젝트 URL과 공개 키가 현재 프로젝트의 값인지 확인합니다. 비밀 키와 사용자 토큰은 로그에 남기지 않습니다.
- Row Level Security 또는 Storage 정책을 변경하기 전에 요청한 사용자와 대상 경로를 기록합니다.
Auth 오류는 인증 오류 코드 (새 창에서 열림), 데이터베이스 오류는 데이터베이스 오류 코드 (새 창에서 열림)에서 원문을 먼저 대조합니다.
관련 구성요소
자주 발생하는 오류·증상
공식 참고 자료
Supabase 공식 문서 (새 창에서 열림)
최종 검토일: 2026-07-27
최근 검토된 문서
Cookie·Session
브라우저 쿠키와 서버 세션 식별자로 로그인·상태를 요청 사이에 유지하는 구성입니다.
new row violates row-level security policy
Supabase Storage 업로드에서 403과 new row violates row-level security policy가 함께 표시되는지 확인하고 저장소 객체의 RLS 범위를 식별합니다.
데이터베이스 오류 코드
데이터베이스 서버나 클라이언트가 연결·질의·무결성 처리 결과를 구분해 반환하는 코드와 메시지입니다.
인증 오류 코드
사용자·토큰·권한 확인 과정에서 인증 시스템이 반환하는 오류 코드와 메시지입니다.