Backend — 관련 콘텐츠 78건

Prisma P2002, unique constraint, 중복 키 | 가입 버튼 두 번이 원인일까?

P2002는 유니크 칸이 이미 차서 넣기를 거절한 줄입니다. 가입 연타는 한 원인일 뿐입니다. meta.target과 메시지의 칸을 읽고, findUnique 다음 create를 끊고, 카카오 이메일은 있는 행으로 로그인합니다. 프리즈마, 넥스트, 슈퍼베이스, PostgreSQL 23505, 백엔드, 1인 개발자 기준. 2026년 9월 프리즈마·포스트그레스 공식 문서.

Prisma P2021, 테이블 없음, migrate | 프리뷰 DB에 스키마가 없으면?

로컬은 되고 버셀 프리뷰만 테이블이 없으면 P2021입니다. generate는 클라이언트만 만들고, 스키마는 migrate deploy가 넣습니다. db push는 로컬 초안용입니다. 프리즈마, 넥스트, 슈퍼베이스, 버셀 프리뷰, PostgreSQL, 백엔드, 1인 개발자 기준. 2026년 9월 프리즈마·버셀 공식 문서.

headers was already sent, API 라우트, res.end | JSON을 두 번 쓰면 왜 500이 되나?

페이지 API에서 JSON을 두 번 쓰면 노드가 헤더를 이미 보냈다고 하고 화면은 500이 된다. res.json 다음 return, headersSent, 앱 라우트 Response 반환을 나눈다. 카카오 콜백과 토스 웹훅에서 200 뒤 오류 칸을 본다. Next.js, Node.js, API, 웹훅, 백엔드, 개발자 기준. 2026년 9월 Node.js, Next.js 공식 문서.

403 Forbidden, RLS, 권한 | 슈퍼베이스에서 select는 되고 insert만 막히면?

조회는 되고 저장만 403이면 행 수준 보안의 넣기 정책이 그 행을 거절한 상태다. 조회 조건과 쓰기 검사, 사용자 아이디, 익명 키와 서비스 롤 키를 나눈다. 슈퍼베이스, 포스트그레, Next.js, API, 백엔드, 보안, 카카오 로그인, 서버 액션, 개발자 기준. 2026년 9월 MDN, 포스트그레, 슈퍼베이스 공식 문서.

429 Too Many Requests, Retry-After, 백오프 | API 한 번에 몰리면 어디를 줄일까?

429는 인증 실패가 아니라 짧은 시간에 호출이 많아 서버가 기다리라고 한 응답이다. Retry-After 초와 HTTP 날짜를 읽고, 헤더가 없으면 지수 백오프에 지터를 넣는다. 크론·웹훅·액션이 같은 키를 쓰면 동시 호출과 배치부터 줄인다. 개발자, API, 백엔드, Node.js, Next.js, 깃허브 기준. 2026년 9월 MDN·RFC 6585·깃허브 REST 문서.

ETIMEDOUT, fetch failed, undici | 배포 함수에서만 타임아웃이면?

배포 함수에서만 fetch가 끊기면 로컬 회선이 빠른 게 아니라 함수 대기 한도와 아웃바운드 경로가 다르다. ETIMEDOUT과 undici fetch failed의 cause.code를 남기고, maxDuration·AbortSignal·리전을 맞춘다. 개발자, Node.js, 버셀, Next.js, 백엔드, API 기준. 2026년 8월 Node.js·MDN·버셀 문서.

CORS 에러, 프리플라이트, Access-Control-Allow-Origin | 로컬은 되는데 배포하면 막히면?

CORS 에러는 코드가 틀려서가 아니라 서버가 응답에 허용 헤더를 안 붙여서 브라우저가 읽기를 막는 것이다. 프로토콜·도메인·포트가 하나라도 다르면 교차 출처가 되고, JSON 본문이나 Authorization 헤더가 붙으면 OPTIONS 프리플라이트가 먼저 날아간다. Access-Control-Allow-Origin·Methods·Headers, 쿠키를 쓸 때 와일드카드 금지와 정확한 출처 반사, Vary Origin, Next.js rewrites 회피까지. 개발자, Next.js, 프론트엔드, 백엔드, API, 보안 기준. 2026년 8월 MDN·Fetch 표준.

쿼리 타임아웃, 락 대기, 트랜잭션 유휴 | 문의 저장이 안 끝나고 풀이 차면?

문의 저장이 안 끝나면 풀부터 늘리지 않는다. 포스트그레 기본은 문장 제한, 락 대기, 트랜잭션 안 유휴를 0으로 둔다. 액션이 커밋 전에 메일을 기다리면 세션이 idle in transaction으로 남는다. 슈퍼베이스 역할은 익명 3초, 인증 8초, 대시보드 역할은 전역 2분 상한이다. 개발자, Next.js, 백엔드, API, PostgreSQL, 슈퍼베이스 기준으로 제한 숫자 칸만 보고 풀 글, 오토배큠 글과 자리를 섞지 않는다. 2026년 8월 공식 문서.

소프트 삭제, 부분 유니크, 널 중복 | 탈퇴한 이메일이 다시 가입되면?

탈퇴 뒤 같은 이메일 재가입은 살아 있는 행만 부분 유니크로 막는다. 테이블 유니크는 죽은 행까지 잡고, 이메일과 삭제 시각 조합은 널을 서로 다른 값으로 본다. 포스트그레, 드리즐, 프리즈마, 슈퍼베이스, 백엔드, API, Next.js, 개발자 기준으로 유니크 칸만 보고 페이지네이션, 타임존 글과 자리를 섞지 않는다. 2026년 8월 공식 문서.

페이지네이션, 오프셋, 키셋, 커서 | 관리자 목록 뒤 페이지가 왜 느려지나?

관리자 목록 뒤 페이지가 느리면 오프셋을 키셋으로 바꾼다. 건너뛴 행도 서버가 만들고, 커서는 마지막 시각과 아이디다. 전체 건수는 매 페이지마다 세지 않는다. PostgreSQL, 백엔드, Next.js, API, 슈퍼베이스, 프리즈마, 드리즐, 개발자, 데이터, 인덱스 기준으로 목록 칸만 보고 오토배큠 글과 자리를 섞지 않는다.

드리즐 ORM, Prisma, 슈퍼베이스 | 1인 개발자가 ORM 고를 때 어디서 갈리나?

드리즐은 TypeScript로 스키마를 직접 쓰고 번들 크기가 작다. Prisma는 .prisma 파일 중심이고 자동 타입 생성이 편하다. Next.js 15 + 슈퍼베이스 환경에서 설치 방법, 마이그레이션 흐름, 서버리스 번들 크기 차이를 비교하고 1인 개발자가 어느 시점에 무엇을 쓰면 되는지 정리한다.

타임스탬프, 타임존, 타임스탬프츠, 한국 표준시 | 로그가 아홉 시간 미래로 찍히는 이유는?

로그가 아홉 시간 미래면 서버가 틀린 게 아니다. 지금 시각에 아홉 시간을 더한 뒤 아이소 문자열을 만들면 Z가 협정시로 읽힌다. 타임스탬프츠, 세션 타임존, 아이소 오프셋, 슈퍼베이스, 알디에스 서울, 노드, PostgreSQL, API, 백엔드, 개발자 기준으로 저장과 표시를 나눈다. 오토배큠 글과 피지바운서 글과 자리를 섞지 않는다.

오토배큠, 죽은 튜플, 트랜잭션 ID, 랩어라운드 | 디스크는 느는데 쿼리가 왜 느려지나?

포스트그레 오토배큠이 막히면 알디에스 디스크만 늘고 쿼리가 느려진다. 죽은 튜플, 일반 배큠과 풀 배큠, 트랜잭션 ID 랩어라운드, 복제 슬롯, 적응형 오토배큠, MaximumUsedTransactionIDs 알람을 백엔드, PostgreSQL, API, 클라우드, 개발자, 데이터 기준으로 같은 표에 둔다. 피지바운서와 쿼리 성능 글과 각을 섞지 않는다.

트랜잭션 아웃박스, 이중 쓰기, CDC, 디비지움 | 주문과 큐를 어떻게 같이 맞출까?

주문 저장과 큐 발행이 다른 커밋이면 없는 주문의 알림이 나가거나 재고 이벤트가 빠진다. 트랜잭션 아웃박스 테이블 칸, 폴링 릴레이와 디비지움 변경 캡처, 파티션 키 순서, 소비 멱등, 논리 복제 슬롯 적체 알람을 백엔드, API, 데이터, PostgreSQL, 클라우드, 개발자, 데브옵스, TypeScript 서비스 기준으로 풀어 쓴 심층 가이드.

낙관적 락, 비관적 락, Redis 분산 락, version | 동시 재고·결제는 어떻게 막나?

재고·잔액·배치에서 읽기-수정-쓰기 레이스를 막는 낙관적 락(version 조건부 UPDATE), 비관적 락(SELECT FOR UPDATE), Redis 분산 락(SET NX PX)을 표와 의사 코드로 비교한다. 멱등 키·메트릭·TTL·트랜잭션 밖 외부 API 규칙을 백엔드·API·개발자·PostgreSQL·큐 운영 관점에서 정리한 심층 가이드.

배치 잡, 크론, 데드 레터, 멱등 | 스케줄러 장애 전에 채울 항목은?

배치 잡·크론 스케줄러 운영 체크리스트다. 잡 인벤토리, 동시 실행 방지(분산 락), 멱등 키, 데드 레터 큐(DLQ), 시작·성공·실패·지연 메트릭, 청크·트랜잭션 경계, 15분 런북, PR 배포 게이트를 표와 목록으로 정리한다. 백엔드·API·큐·온콜·클라우드 스케줄·개발자 실무에서 자정 중복 정산·재시도 폭주·데이터 손상을 줄이는 점검 순서와 관측 항목.

Fastify, Hono, Express, API 라우팅 | Node 백엔드 프레임워크는 언제 갈라질까?

Fastify·Hono·Express를 런타임·JSON 스키마·플러그인·엣지 배포·팀 이전 비용 기준으로 표 비교한다. Node API·REST·TypeScript·미들웨어·OpenAPI·BFF 선택, tRPC·Elysia와의 경계, 카나리 이전 체크리스트와 공식 문서 출처를 개발자·백엔드 관점에서 정리한 vs-comparison 가이드.

웹훅 재시도 폭주, 멱등 키, 중복 결제 | 콜백을 한 번만 반영한 순서는?

결제 웹훅 재시도 폭주로 포인트가 세 번 적립된 백엔드 장애 케이스다. event_id 유니크만으로는 부족한 이유, 수신 인박스·멱등 키·트랜잭션 아웃박스 도입 순서, ACK 시점과 워커 SKIP LOCKED, 도입 전후 지표와 온콜 런북, PostgreSQL·API 연동 FAQ를 문제→시도→결과로 정리한 개발자 가이드.

무중단 DB 스키마 마이그레이션 체크리스트 2026 | expand-contract·백필·롤백

무중단 데이터베이스 스키마 마이그레이션 체크리스트. 확장-축소(expand-contract), 백필·이중 쓰기, 위험 DDL 표, 인덱스·락·타임아웃, N-1 앱 호환, 롤백 구간, Flyway·Prisma·golang-migrate 선택, PostgreSQL ALTER·CREATE INDEX 참고와 백엔드·API·데브옵스 배포 전 점검 항목을 정리한다.

외부 API 회로 차단기 도입 케이스 2026 | 타임아웃 폭주·스레드 고갈·격리

외부 본인인증 API 지연이 결제·장바구니까지 연쇄 장애로 번진 팀의 포스트모템 케이스다. 타임아웃·재시도 핫픽스, 워커 분리, 회로 차단기(Circuit Breaker) Closed·Open·Half-Open 임계값, 폴백·메트릭·기능 플래그 롤아웃 전후 숫자를 정리한다. 백엔드·API·개발자·Sentry·구조화 로깅·Rate limiting 연계 가이드.