개발자일지

[ReactJS] npm error Missing script: "start", react-scripts@5.0.1 본문

개발 준비/ReactJS&TypeScript

[ReactJS] npm error Missing script: "start", react-scripts@5.0.1

TTH 2025. 5. 9. 15:23
728x90
반응형

 

npm error Missing script: "start"

 

 

오류 원인

이 에러는 npm start를 실행하려고 했지만, package.json 파일 안에 "start" 스크립트가 없어서 생기는 문제이다.
npm error Missing script: "start" 에러가 나는 이유는 package.json 안에 아래와 같은 항목이 없기 때문이다.

"scripts": {
  "start": "react-scripts start"
}


또는

"scripts": {
  "start": "node index.js"
}

 

 

오류 해결 방법

1. package.json 열기
C:\dev\softlanders_platform\softlanders-new\package.json 파일을 연다.

2. "scripts" 항목 확인
예: React 프로젝트라면 보통 이렇게 되어 있어야 한다.

"scripts": {
  "start": "react-scripts start",
  "build": "react-scripts build",
  "test": "react-scripts test"
}


3. 스크립트를 직접 추가하기
React 앱이라면 아래의 스크립트를 추가한다.

"scripts": {
  "start": "react-scripts start"
}

 

단, react-scripts가 설치되어 있어야 한다. 설치되어 있지 않다면 다음 명령어로 설치를 진행한다.

npm install react-scripts


Node.js 서버라면 아래와 같이 스크립트를 추가한다.

"scripts": {
  "start": "node index.js"
}



npm run 명령어를 입력하면 현재 정의된 스크립트를 보여준다. 
아래 명령어를 실행하여 정의된 스크립트를 확인한다.

npm run

 

 


 

 

설치했는데 오류가 나는 경우

react-scripts@5.0.1 에러

이 에러는 react-scripts@5.0.1이 TypeScript 버전과 충돌하고 있어서 .생기는 문제이다. 프로젝트에 typescript@5.0.1 보다 높은 버전이 설치되어 있다면 에러가 날 수 있다. react-scripts@5.0.1은 typescript@^3.2.1 || ^4까지만 지원하기 때문이다. 버전이 맞지 않으면 react-scripts가 아예 설치되지 않기 때문에 오류가 해결되지 않는 것이다.

 

해결 방법, TypeScript 버전 낮추기 (권장)

typescript를 호환되는 버전으로 낮춘다(예: 4.9.5)

npm install typescript@4.9.5 --save-dev


그다음 react-scripts를 설치한다.

npm install react-scripts
728x90
반응형