에러 해결

개발 에러 해결 모음

콘솔에 뜬 빨간 에러, 검색하기도 막막하죠. 자주 만나는 오류 메시지를 모아 원인과 해결 방법을 예제로 정리했습니다. 에러 메시지의 키워드로 찾아보세요.

JavaScript전체 보기 →

TypeError: Cannot read properties of undefined 해결 방법

TypeError: Cannot read properties of undefined (reading 'x')

자바스크립트에서 가장 흔한 런타임 오류 'Cannot read properties of undefined'의 원인과 옵셔널 체이닝·기본값으로 안전하게 해결하는 방법을 정리합니다.

TypeError: x is not a function 해결

TypeError: someValue is not a function

함수가 아닌 값을 호출하거나 메서드 이름 오타·import 실수로 발생하는 'is not a function' 오류의 원인과 해결 방법을 정리합니다.

React · Next.js전체 보기 →

React/Next.js Hydration failed 오류 해결

Hydration failed because the initial UI does not match what was rendered on the server

Next.js에서 자주 만나는 hydration 불일치 오류의 원인(서버·클라이언트 렌더 결과 차이)과 해결 방법을 예제로 정리합니다.

React: Maximum update depth exceeded 해결

Maximum update depth exceeded

React에서 렌더 중 setState가 반복 호출되어 발생하는 무한 루프 오류의 원인과 해결 방법을 예제로 설명합니다.

'process is not defined' 오류 해결 (Vite·브라우저)

Uncaught ReferenceError: process is not defined

브라우저 환경에서 Node 전용 전역 process를 참조해 발생하는 'process is not defined' 오류의 원인과 환경변수 접근 방법(Vite의 import.meta.env 등)을 정리합니다.

React: Objects are not valid as a React child 해결

Objects are not valid as a React child (found: object with keys {...})

JSX에서 객체나 배열을 그대로 렌더링하려 할 때 발생하는 React 오류의 원인과 올바른 출력 방법을 예제로 정리합니다.

네트워크 · API전체 보기 →

CORS 오류: No 'Access-Control-Allow-Origin' 해결

Access to fetch at '...' from origin '...' has been blocked by CORS policy

fetch/axios 요청 시 발생하는 CORS 정책 오류의 원리와 서버·프록시·개발환경별 해결 방법을 정리합니다.

Unexpected token '<' / JSON.parse 오류 해결

SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON

fetch 응답을 JSON으로 파싱할 때 HTML(에러 페이지)이 돌아와 발생하는 'Unexpected token <' 오류의 원인과 해결 방법을 정리합니다.

401 Unauthorized 오류 해결 (인증 실패)

GET /api/... 401 (Unauthorized)

API 요청 시 발생하는 401 Unauthorized의 의미와 토큰 누락·만료·헤더 형식 문제를 점검해 해결하는 방법을 정리합니다.

npm · 패키지전체 보기 →

npm ERR! ERESOLVE 의존성 충돌 해결

npm ERR! code ERESOLVE — unable to resolve dependency tree

npm install 시 발생하는 ERESOLVE peer dependency 충돌의 원인과 안전한 해결 순서(--legacy-peer-deps 포함)를 정리합니다.

Module not found: Can't resolve '...' 해결

Module not found: Error: Can't resolve './xxx'

import 경로가 잘못되었거나 패키지가 설치되지 않아 발생하는 'Module not found' 오류의 원인과 경로·설치·별칭(alias) 관점의 해결 방법을 정리합니다.

npm EACCES: permission denied 해결

npm ERR! code EACCES — permission denied

전역 npm 설치 시 발생하는 EACCES 권한 오류의 원인과, sudo 대신 권한·경로를 바로잡아 안전하게 해결하는 방법을 정리합니다.

Node.js · 실행전체 보기 →

EADDRINUSE: port 3000 is already in use 해결

Error: listen EADDRINUSE: address already in use :::3000

Node.js 개발 서버 실행 시 포트가 이미 사용 중일 때 나타나는 EADDRINUSE 오류를, 점유 프로세스 종료·포트 변경으로 해결하는 방법을 OS별로 정리합니다.

Git merge conflict (병합 충돌) 해결 방법

CONFLICT (content): Merge conflict in <file>

git merge/pull 시 발생하는 병합 충돌의 의미와 충돌 마커(<<<<<<<, =======, >>>>>>>)를 직접 해결하는 단계별 방법을 정리합니다.

TypeScript전체 보기 →

TS: Type 'X' is not assignable to type 'Y' 해결

Type 'string' is not assignable to type 'number'

TypeScript에서 타입이 맞지 않을 때 나는 'is not assignable' 오류의 원인과 타입 좁히기·제네릭·단언으로 해결하는 방법을 정리합니다.

CSS · 스타일전체 보기 →

CSS z-index가 안 먹힐 때 해결 방법

z-index에 큰 값을 줘도 요소가 위로 안 올라옴

z-index가 적용되지 않는 흔한 원인(position 누락, 쌓임 맥락)과 해결 방법을 예제로 정리합니다.