[Flutter] Waiting for another flutter command to release the startup lock 이슈 해결

Flutter 실행이 안 될 때!

“Waiting for another flutter command to release the startup lock” 오류 해결법 정리

Flutter 프로젝트를 열심히 개발하던 중, 갑자기 터미널이나 VS Code에서 flutter run 또는 flutter pub get 같은 명령어를 실행했을 때 이런 메시지를 본 적 있으신가요?

Waiting for another flutter command to release the startup lock...

 

처음엔 “뭔가 기다리면 되겠지” 하고 방치하지만, 5분이 지나도, 10분이 지나도 그대로일 때… 그 답답함은 이루 말할 수 없죠.

이 오류가 왜 생기는지, 어떻게 해결하면 되는지, 재발 방지를 위해 할 수 있는 팁까지 정리해서 안내해드릴게요.

---

▶ 이 오류는 왜 발생할까?

Flutter는 여러 명령어가 동시에 실행되면 충돌 방지를 위해 .flutter_tool_state와 flutter/bin/cache/lockfile 같은 락(lock) 파일을 만들어 다른 명령이 실행되지 않도록 막아요.

하지만 다음과 같은 상황에서는 이 락이 풀리지 않고 남아버리기도 합니다:

• 이전 Flutter 명령이 강제 종료되었을 때 (예: Ctrl + C, 터미널 강제 종료 등)
• 여러 터미널에서 Flutter 명령어를 동시에 실행했을 때
• IDE가 비정상 종료되었을 때
• 디스크 I/O 문제로 락 파일이 제대로 삭제되지 않은 경우

이렇게 락이 남아 있으면, 이후 실행되는 명령어들이 계속 기다리기만 하게 되는 거죠.

---

▶ 가장 확실한 해결법

1. 락 파일 직접 삭제

가장 빠른 해결 방법은 락 파일을 수동으로 삭제하는 것입니다.

rm -f ~/flutter/bin/cache/lockfile

 

혹은 Flutter SDK 경로가 다르다면, 아래처럼 해당 경로에서 직접 삭제해 주세요.

cd [FLUTTER_SDK_PATH]/bin/cache
rm lockfile

 

2. 모든 Flutter 관련 프로세스 종료

특히 macOS나 Linux에서는 Flutter 관련 프로세스가 백그라운드에서 계속 돌아가고 있을 수 있습니다.

ps aux | grep flutter

 

이후 관련 PID를 찾아서 강제로 종료합니다.

kill -9 [PID]

 

Windows에서는 작업 관리자(Task Manager) 에서 dart, flutter 관련 프로세스를 종료해 주세요.

 

3. VS Code 혹은 Android Studio 완전히 종료

Flutter 명령어가 IDE 내부에서 실행되다 멈춘 경우도 많습니다.
모든 VS Code 창을 닫고, 작업 관리자에서 프로세스도 완전히 종료한 뒤 다시 시도해 보세요.

---

▶ 자주 발생할 경우 해결 팁

이 오류가 반복된다면, 다음 팁을 참고해보세요.

1. IDE 설정 확인

VS Code나 Android Studio에서 자동으로 Flutter 명령어를 실행하는 확장 기능이 충돌을 일으킬 수 있어요. 필요 없는 확장 기능은 비활성화하는 것이 좋습니다.

2. Flutter SDK 재설치

SDK 자체가 손상됐을 수도 있으니, 백업 후 재설치를 시도해 보세요.

flutter upgrade
flutter doctor

 

또는 전체 삭제 후 재설치도 방법입니다.

3. 프로젝트 캐시 초기화

특정 프로젝트에서만 발생한다면 .dart_tool, build, .idea 디렉터리를 삭제하고 재빌드해보세요.

 

 

 

 

---

Flutter vs React Native: 초보 개발자는 뭘 선택해야 할까?

StatelessWidget과 StatefulWidget, 뭐가 다른 건데?

Flutter 상태관리, Provider vs GetX vs Bloc

Flutter로 간단한 다크모드 앱 구현해보기