넥스트 — 관련 콘텐츠 54건

엣지 런타임, 노드 모듈 미지원, 미들웨어 | 배포 로그만 모듈을 거절하면?

엣지 런타임은 fs, crypto, pg 같은 노드 모듈을 열지 못합니다. 로그에 찍힌 모듈을 미들웨어 임포트에서 빼고, 데이터베이스는 노드 라우트로 옮깁니다. 해시는 웹 크립토로 바꿉니다. 개발 서버가 조용해도 배포 번들은 거절할 수 있습니다. Next.js, 미들웨어, 버셀, 한국 1인 개발. 2026년 10월 문서.

proxy.ts, 미들웨어, Next.js 16 | 파일만 바꿨는데 함수가 안 돌면?

넥스트 16에서 요청 앞 파일은 proxy.ts이고 함수 이름도 proxy여야 합니다. 파일만 바꾸면 로그인 이동이 조용히 사라집니다. 엣지가 필요할 때만 예전 파일을 남기고, 매처가 경로를 빼먹는 문제와는 자리를 가릅니다. 설정 키의 예전 이름은 같이 바꿉니다. Next.js, 프론트, 한국 1인 개발. 2026년 9월 16.3 문서.

이벤트 핸들러, 클라이언트 컴포넌트, 서버 컴포넌트 | 클릭 함수만 넘기면 막히면?

Event handlers cannot be passed는 서버 컴포넌트가 onClick 함수를 클라이언트 속성으로 넘긴 직렬화 오류입니다. 버튼 파일로 나누고 주문 번호만 넘기며, 서버 함수만 예외입니다. useState 지시자 오류와 줄을 가릅니다. Next.js, use client, 프론트, 한국 1인 개발. 2026년 8월 경계 문서.

413, body size, 서버 액션 | 업로드만 본문 한도에 걸리면?

업로드만 413이면 파일이 깨진 게 아니라 서버 액션 기본 1MB 또는 버셀 함수 4.5MB 본문 한도를 넘긴 줄입니다. bodySizeLimit으로 올리는 한도와 플랫폼 한도를 나누고, 더 큰 파일은 함수 밖으로 보냅니다. Next.js, Vercel, nginx, 한국 1인 개발자 기준. 2026년 9월 serverActions와 Functions 한도 문서.

Dynamic server usage, cookies, 정적 생성 | 빌드만 쿠키에서 멈추면?

Dynamic server usage는 쿠키 API가 고장난 게 아니라 정적 생성 중 cookies 호출이 요청 흐름 밖으로 새어 빌드가 멈춘 줄입니다. try로 감싼 쿠키, setTimeout, 루트 레이아웃을 나눕니다. Next.js, 한국 1인 개발자 기준. 2026년 9월 dynamic server error 문서.

use client, useState, 서버 컴포넌트 | 버튼만 눌러도 훅이 막히면?

use client가 없으면 useState와 onClick은 서버 컴포넌트에서 실행되려다 막힙니다. 훅이 고장난 게 아니라 파일 맨 위 지시어와 직렬화 가능한 props 경계가 비어 있는 줄입니다. 버튼만 클라이언트로 나누고 레이아웃 전체를 옮기지 않는 순서를 봅니다. Next.js, 리액트, 한국 1인 개발자 기준. 2026년 9월 Next.js use client 문서.

Maximum update depth, useEffect, 무한 루프 | 이펙트가 서로를 부르면?

Maximum update depth exceeded는 훅이 고장난 게 아니라 그린 뒤 이펙트가 상태를 바꾸고 그 상태가 다시 이펙트를 불러 한도를 넘긴 줄입니다. Too many re-renders와 구분하고, 객체 의존, 파생 값, 함수형 업데이트를 봅니다. React, Next.js, 한국 1인 개발자 기준. 2026년 9월 React useEffect·에러 185 문서.

redirect_uri_mismatch, 카카오 콜백, REST 키 | 로컬은 되고 프리뷰만 실패하면?

redirect_uri_mismatch와 카카오 KOE006은 코드가 틀린 게 아니라 요청에 실은 콜백 주소가 콘솔 등록 문자열과 한 글자라도 다른 줄입니다. http와 https, 끝 슬래시, REST 키와 JS 키, 프리뷰 호스트. 카카오, 구글, Next.js, 한국 1인 개발자 기준. 2026년 9월 카카오 로그인 REST·구글 OAuth 문서.

Prisma query engine, OpenSSL, Alpine | 도커만 엔진이 없으면?

프리즈마 쿼리 엔진을 못 찾으면 SQL이 틀린 게 아니라 그 운영체제와 OpenSSL에 맞는 바이너리가 이미지 안에 없는 줄입니다. binaryTargets, 알파인 musl, 이미지 안 generate. Prisma, Docker, Next.js, 한국 1인 개발자 기준. 2026년 9월 프리즈마 제너레이터·스키마 문서.

JSON.parse, Unexpected token, HTML 응답 | 파서가 '<'에서 멈추면?

JSON.parse가 Unexpected token '<'를 내면 파서가 틀린 게 아니라 받은 본문이 JSON이 아니라 HTML입니다. 상태 코드, Content-Type, 상대 경로가 페이지로 붙는 배포. Node.js, Next.js, fetch, 한국 1인 개발자 기준. 2026년 9월 MDN JSON.parse·Route Handlers 문서.

EMFILE, too many open files, ulimit | 파일을 더 못 열면?

EMFILE은 디스크가 가득 찬 줄이 아니라 그 프로세스가 동시에 열 수 있는 파일 개수 한도를 이미 다 써서 새 파일을 못 연 줄입니다. ENOSPC 워처와 구분, ulimit, launchd, watch ignored. Node.js, Next.js, 맥, 한국 1인 개발자 기준. 2026년 9월 Node.js 에러·webpack watch 문서.

ERR_TOO_MANY_REDIRECTS, 리다이렉트 루프, trailingSlash | 배포만 화면이 돌면?

ERR_TOO_MANY_REDIRECTS는 페이지가 없어서가 아니라 Location이 서로를 가리키다 브라우저 한도를 넘긴 줄입니다. 슬래시 왕복, HTTPS·www, 로그인 matcher, 카카오 콜백 URI. Next.js, 버셀, 한국 1인 개발자 기준. 2026년 9월 MDN 리다이렉트·Next.js trailingSlash 문서.

ENOSPC, file watchers, inotify | 넥스트 감시가 멈추면?

ENOSPC file watchers는 디스크가 가득 찬 줄이 아니라 리눅스 inotify 감시 개수를 개발 서버가 다 쓴 줄입니다. node_modules ignored, sysctl 한도, 맥과 우분투 CI. Next.js, 웹팩, 한국 1인 개발자 기준. 2026년 9월 Next.js ENOSPC·inotify 문서.

Permission denied publickey, SSH 키, github | git push가 막히면?

Permission denied (publickey)는 저장소 권한이 없어서가 아니라 이번 SSH 시도에 깃허브가 받은 공개키가 계정에 없어 거절한 줄입니다. 접속 시험, 에이전트, 키 전용 옵션, 배포 키를 순서대로 봅니다. GitHub, 맥, 한국 1인 넥스트 기준. 2026년 9월 깃허브 SSH 공식 문서.

UNABLE_TO_VERIFY_LEAF_SIGNATURE, 자체 서명 인증서, NODE_TLS | HTTPS만 실패하면?

UNABLE_TO_VERIFY_LEAF_SIGNATURE는 코드가 틀린 게 아니라 노드가 HTTPS 리프 서명을 신뢰 저장소로 검증하지 못해 핸드셰이크를 끊은 줄입니다. 중간서, 회사 프록시, mkcert, NODE_EXTRA_CA_CERTS. Node.js, Next.js, 한국 1인 개발자 기준. 2026년 9월 Node.js TLS·CLI 문서.

ECONNRESET, socket hang up, 연결 리셋 | 요청이 중간에 끊기면?

ECONNRESET은 포트가 비어서 거절된 줄이 아니라 한 번 붙었던 소켓을 상대가 갑자기 닫아서 요청이 중간에 끊긴 줄입니다. 원인 코드, 연결 재사용, 토스·카카오 웹훅은 성공 응답을 먼저 보냅니다. Node.js, Next.js, 한국 1인 개발자 기준. 2026년 9월 Node.js 에러·MDN Fetch 문서.

NEXT_PUBLIC, process.env, 환경변수 | 로컬은 되고 클라이언트만 비면?

클라이언트에서 NEXT_PUBLIC 값이 비면 런타임이 거절한 게 아니라 빌드 시점에 그 키가 번들에 안 박힌 줄입니다. 접두사, 통째 표기, 버셀 Preview 토글, 재배포. Next.js, 버셀, 한국 1인 개발자 기준. 2026년 9월 Next.js 환경변수 문서.

Too many re-renders, setState, 무한 렌더 | 화면이 멈추고 콘솔만 도나?

Too many re-renders는 훅이 고장난 게 아니라 그리는 도중에 setState가 다시 그려짐을 불러 한도를 넘긴 줄입니다. onClick 호출, 렌더 몸통 갱신, Maximum update depth와 구분. React, Next.js, 한국 1인 개발자 기준. 2026년 9월 React useState 문서.

Prisma P2002, unique constraint, 중복 키 | 같은 값인데 저장만 막히면?

프리즈마 P2002는 표가 없어서가 아니라 유니크 칸에 이미 같은 값이 있어 저장을 거절한 줄입니다. meta.target, 카카오 로그인 upsert, 시드와 프리뷰 디비. Prisma, 슈퍼베이스, Next.js, 1인 개발자 기준. 2026년 9월 프리즈마 오류 문서.

ETIMEDOUT, 연결 시간 초과, fetch | 거절이 아니라 기다리다 죽으면?

ETIMEDOUT은 거절이 아니라 소켓이 응답을 기다리다 한도를 넘긴 줄입니다. ECONNREFUSED, ENOTFOUND, 서버리스 함수 한도와 구분하고 AbortSignal.timeout을 명시합니다. Node.js, Next.js, 한국 1인 개발자 기준. 2026년 9월 Node 에러·MDN fetch 문서.