Next.js — 관련 콘텐츠 97건

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·버셀 문서.

ELIFECYCLE, npm ERR, 빌드 스크립트 | 로컬은 되고 CI만 빨간 줄이면?

ELIFECYCLE은 npm이 감싼 실패다. 실제 원인은 위 도구 로그와 종료 숫자다. 로컬은 되고 통합 환경만 실패하면 노드 버전, 잠금 파일 설치, 환경변수, 맥과 리눅스 대소문자부터 맞춘다. 개발자, npm, 깃허브 액션, Next.js, Node.js, 데브옵스 기준. 2026년 8월 npm과 깃허브 공식 문서 기준.

Heap out of memory, Node.js 메모리, --max-old-space-size | 빌드가 137로 죽으면?

빌드 종료 코드 137은 문법 오류가 아니라 커널이 프로세스를 죽인 신호다. 힙 메시지와 러너 메모리를 같이 보고, 원본 이미지를 줄인 뒤 공식 힙 상한만 올린다. 한국 1인 개발자, Node.js, Next.js, 깃허브 액션, 도커, CI, 빌드 기준. 2026년 8월 Node.js와 Next.js, 깃허브 공식 문서.

Cannot find module, 모듈을 찾을 수 없음, node_modules | 지워도 같은 줄이 뜨면 뭐부터 볼까?

Cannot find module은 패키지가 없어서가 아니라 노드가 이름을 찾을 폴더를 지나쳤거나 대소문자가 달라서 난다. node_modules를 지워도 같으면 cwd와 require 이름부터 본다. 크론, 깃허브 액션, 맥과 리눅스 CI, npm ci. 개발자, Node.js, npm, Next.js, 백엔드 기준. 2026년 8월 Node.js·npm 공식 문서.

하이드레이션 미스매치, Hydration failed, 서버 클라이언트 불일치 | 콘솔에 빨간 줄이 뜨면 뭐부터 볼까?

Hydration failed는 코드가 틀린 게 아니라 서버가 그려 보낸 HTML과 브라우저 첫 렌더가 달라 리액트가 그 부분을 버리고 다시 그리는 것이다. new Date·Math.random·window·localStorage를 화면 그릴 때 읽거나, p 안의 div 같은 잘못된 HTML 중첩이 흔한 원인이다. 리액트 19 diff와 onRecoverableError로 범인을 찾고, useEffect 두 번 그리기·isClient 상태·dynamic ssr false·suppressHydrationWarning으로 안전하게 고치는 법까지. 개발자, Next.js, 리액트, 프론트엔드, SSR 기준. 2026년 8월 Next.js·React 공식 문서.

EADDRINUSE, 포트 이미 사용 중, 프로세스 종료 | 3000번이 안 죽으면 뭐부터 볼까?

EADDRINUSE address already in use는 코드가 틀린 게 아니라 쓰려는 포트를 이미 다른 프로세스가 쥐고 있어서 서버가 바인딩을 못 하는 것이다. lsof -i :3000·netstat -ano로 PID를 찾고, kill·kill -9·taskkill /F·npx kill-port로 그 하나만 종료한다. nodemon·pm2·도커가 자꾸 되살리는 경우, TIME_WAIT, PORT 환경변수와 next dev -p로 포트 옮기기, Ctrl+C 정상 종료 예방까지. 개발자, Next.js, 노드, 백엔드, 터미널 기준. 2026년 8월 Node.js·마이크로소프트 문서.

npm ERESOLVE, 피어 의존성 충돌, legacy-peer-deps, overrides | 설치가 멈추면 뭐부터 볼까?

npm ERESOLVE unable to resolve dependency tree는 코드가 아니라 어떤 패키지가 요구하는 피어 버전과 설치된 버전이 어긋나서 난다. npm 7부터 피어 의존성을 설치 시점에 엄격 검사하기 때문이다. npm explain·npm ls로 충돌 출처를 찾고, 버전 맞추기와 package-lock 재생성, npm 8.3 overrides로 전이 의존성 고정, --legacy-peer-deps와 --force의 차이와 위험까지. 개발자, Next.js, 리액트, 프론트엔드, npm, 오픈소스 기준. 2026년 8월 npm 공식 문서.

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 표준.

error.tsx, not-found, global-error, digest | 없는 글인데 500이 뜨면?

없는 글인데 500이 뜨면 행이 없을 때 throw 한 것이다. notFound는 없음 칸을 열고, 에러 파일은 예기치 않은 예외만 받는다. 같은 폴더 레이아웃은 에러 파일이 안 감싸고, 프로덕션은 digest로 서버 로그와 맞춘다. 개발자, Next.js, 프론트엔드, React, API, 버셀 기준으로 404와 500 칸만 보고 폼 훅 글, 프록시 글과 자리를 섞지 않는다. 2026년 8월 공식 문서.

lefthook, husky, git 훅, pre-commit | 커밋은 됐는데 린트가 안 돌면?

허스키를 깔아도 커밋이 그냥 나가면 훅 파일이 저장소에 없는 것이다. 허스키는 준비 스크립트가 훅 자리를 만들고, 레프트훅은 설정 파일과 설치 한 줄이다. 피엔피엠은 빌트 의존에 없으면 설치 후 스크립트를 건너뛴다. 개발자, 오픈소스, 깃허브, Next.js, 프론트엔드, 린트, API, 데브옵스 기준으로 로컬 훅 칸만 보고 시크릿 글, 액션 동시성 글과 자리를 섞지 않는다. 2026년 8월 공식 문서.

direnv, .envrc, dotenv, 폴더 환경 | 옆 사이트 키가 셸에 남으면?

옆 사이트 슈퍼베이스 주소가 셸에 남으면 넥스트 환경 파일이 아니라 터미널이 안 지운 것이다. source는 폴더를 나가도 남고, 디렉브는 나갈 때 뺀다. 넥스트는 프로세스 값이 파일보다 앞이다. 개발자, Next.js, 슈퍼베이스, 백엔드, API, 깃허브, 데브옵스 기준으로 셸 언로드 칸만 보고 시크릿 글, 미즈 글, includeIf 글과 자리를 섞지 않는다. 2026년 8월 공식 문서.

프록시, matcher, 서버 액션, 관리자 경로 | 화면만 잠그면 저장이 열릴까?

관리 화면이 로그인으로 튕겨도 서버 액션 POST는 남을 수 있다. 넥스트 16 프록시는 미들웨어 자리이고, matcher가 api나 그 경로를 빼면 그 칸의 액션은 안 탄다. 페이지 권한은 화면만 가리고, 액션 안에서 세션을 다시 본다. 개발자, Next.js, 보안, API, 백엔드, 프론트엔드, 서버 액션 기준으로 matcher와 액션 칸만 보고 세임사이트 글, 폼 훅 글과 자리를 섞지 않는다. 2026년 8월 공식 문서.

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

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

깃허브 환경, 필수 검토, 대기 타이머, 환경 시크릿 | 프로덕션 토큰이 프리뷰 잡에 열리면?

프리뷰 잡이 프로덕션 토큰을 읽으면 값이 저장소 시크릿에 있습니다. 깃허브 환경 시크릿은 그 환경을 적은 잡만 열고, 필수 검토와 대기 타이머는 무료, 프로, 팀의 공개 저장소에만 있습니다. 개발자, 깃허브, Next.js, 데브옵스, 클라우드, API, 백엔드, 버셀 기준으로 배포 잡이 여는 시크릿 칸만 보고 동시성 글, 오아이디씨 글과 자리를 섞지 않습니다. 2026년 8월 깃허브 공식 문서.

깃허브 릴리스, 체인지로그, git-cliff, 공개 노트 | 사용자가 뭐가 바뀌었는지 못 찾으면?

사용자가 뭐가 바뀌었는지 못 찾으면 공개 노트가 커밋 로그이거나 깃허브에만 있습니다. 체인지로그 파일은 저장소에 두고, 깃허브 릴리스는 그 칸을 복사합니다. 깃클리프는 규약 커밋 초안만 뽑습니다. 개발자, Next.js, 깃허브, 백엔드, 데브옵스, API 기준으로 공개 노트 칸만 보고 알림톡 글, 기능 플래그 글과 자리를 섞지 않습니다. 2026년 8월 킵어체인지로그, 깃클리프, 깃허브 공식 문서.

노드 권한, 허용 읽기, 허용 쓰기, 크론 | 검수 스크립트가 홈 폴더를 열면?

검수 스크립트가 홈 폴더를 열면 허용 목록이 없거나 별표입니다. 노드 권한 모델은 22.13부터 안정이고, 퍼미션 플래그를 켜면 읽기 쓰기가 기본 거절입니다. 쓰기는 포스트 폴더만 엽니다. 2026년 7월 보안 배포 패치를 먼저 봅니다. 개발자, Next.js, 노드, API, 백엔드, 데브옵스, 깃허브, 보안 기준으로 프로세스 칸만 보고 테스트 러너 글, 시크릿 글과 자리를 섞지 않습니다.

after, waitUntil, 응답 후 작업, 페이지뷰 | 문의 저장이 끝났는데 버튼이 안 풀리면?

문의 저장이 끝났는데 버튼이 안 풀리면 액션이 메일을 기다린 겁니다. Next.js after는 응답을 보낸 뒤에 로그와 페이지뷰를 돌리고, 버셀은 15.1부터 대기 유틸 대신 이 함수를 권합니다. 정적 페이지에서는 빌드 때 돕니다. 프론트엔드, React, 서버 액션, API, 개발자, 백엔드, 넥스트 기준으로 응답 뒤 칸만 보고 폼 훅 글, 캐시 헤더 글과 자리를 섞지 않습니다. 2026년 8월 넥스트, 버셀 공식 문서.

메일핏, 메일호그, 로컬 SMTP, 1025 | 문의 메일이 실제 주소로 나가면?

로컬 문의 메일이 실제 주소로 나가면 수신을 1025번에 두고 릴레이는 끈다. 메일핏 화면은 8025번이고, 메일호그는 2020년 이후 갱신이 끊겼다. 오픈소스, 개발자, Next.js, 노드메일러, 리센드, 백엔드, API, 도커 기준으로 로컬 칸만 보고 디킴 디엔에스 글, 폼 훅 글과 자리를 섞지 않는다. 2026년 8월 메일핏 공식 문서.

includeIf, git 계정, SSH 호스트, 커밋 이메일 | 회사 저장소에 개인 메일이 찍히면?

회사 폴더 커밋에 개인 지메일이 찍히면 전역 user.email이 덮은 겁니다. includeIf gitdir로 회사와 개인 설정을 나누고, SSH는 호스트 별칭과 IdentitiesOnly로 키를 가릅니다. user.useConfigOnly가 비면 깃이 멈춥니다. 개발자, 깃허브, Next.js, 백엔드, 데브옵스, API, 워크트리 기준으로 계정 칸만 보고 핫픽스 워크트리, 미즈 버전 글과 자리를 섞지 않습니다. 2026년 8월 깃, 깃허브 공식 문서.