Flutter (앱 개발)/Flutter 오류 해결 방법

PowerShell에서 flutterfire 명령어가 인식되지 않는 오류 해결 방법

Ize𓆜 2025. 4. 21. 21:17
728x90
728x90

 


Ⅰ. 오류 원인

 

PowerShell에서 flutterfire 명령어 인식되지 않는 문제

 

Flutter 프로젝트에서

 flutterfire 명령어를

 실행하려고 할 때,

 PowerShell에서 

명령어가 인식되지 않는 오류가 

발생하는 경우가 있습니다. 

 

이 오류는 

주로 시스템 환경 변수 설정이 부족하거나

 잘못된 경우에 발생합니다.

 

 

 flutterfire는

 Flutter 프로젝트에서

 Firebase와 연결하기 위해

 필요한 명령어인데, 

 

이를 인식하지 못하면

 Firebase 설정을 진행할 수 없습니다.

 


환경 변수 경로 미설정

 

flutterfire 명령어가

 제대로 실행되지 않는 이유는 

시스템 환경 변수에

 Flutter SDK 경로가

 추가되지 않았기 때문입니다.

 

 이는 flutterfire 명령어가 포함된 

디렉토리를 시스템이 인식하지 못해

 발생하는 문제입니다. 

 

환경 변수 설정을 통해 

해결할 수 있습니다.


Ⅱ. 해결 순서

 

시스템 환경 변수 설정 열기

 

먼저,

 Windows 환경 변수 설정을

 열어야 합니다. 

 

이를 위해 

Windows 키 + R을 눌러

 실행 창을 열고, 

sysdm.cpl을 입력한 후

 확인을 클릭합니다.


환경 변수 창 열기

 

 

"시스템 속성" 창이 열리면, 

상단의 고급 탭을 선택한 후, 

환경 변수 버튼을 클릭합니다.


 Path 변수 수정

 

환경 변수 창에서 

사용자 변수 섹션에 있는

 Path를 선택하고, 

편집 버튼을 클릭합니다. 

 

이어서 

새로 만들기 버튼을 클릭하여

 Flutter의

 flutterfire 명령어가 

포함된 경로인

 설치 경로\AppData\Local\Pub\Cache\bin을 입력하고

 확인을 클릭하여 

변경 사항을 저장합니다.

 


PowerShell 재시작 및 명령어 실행

 

환경 변수를 설정한 후에는 

PowerShell을 새로 열고, 

프로젝트 디렉토리로 이동하여

 flutterfire configure 명령어를 

다시 실행해봅니다. 

이제 flutterfire 명령어가 정상적으로

 인식되어 실행될 것입니다.

 

요약 하면 아래와 같습니다.

Windows에서 환경 변수를 추가하는 방법:

  1. Windows 키 + R을 눌러 실행 창을 엽니다
  2. sysdm.cpl 입력하고 확인
  3. "고급" 탭 선택
  4. "환경 변수" 버튼 클릭
  5. "사용자 변수" 섹션에서 "Path" 선택
  6. "편집" 버튼 클릭
  7. "새로 만들기" 클릭
  8. C:\Users\PC_1M\AppData\Local\Pub\Cache\bin 입력
  9. "확인" 버튼을 눌러 모든 창을 닫기

 

환경 변수를 추가한 후에는:

  1. PowerShell을 새로 열기
  2. 프로젝트 디렉토리로 이동
  3. flutterfire configure 명령어 다시 실행

 


Ⅲ.  느낀점

 

환경 변수 설정의 중요성

이번 오류를 해결하면서 

시스템 환경 변수 설정의 

중요성을 다시 한 번 느꼈습니다. 

 

개발 환경에서 많은 명령어들이

 경로 설정에 의존하기 때문에, 

환경 변수를 올바르게 설정하는 것이

 매우 중요합니다.


개발 중 오류 해결의 과정

 

Flutter와 Firebase 연결을 위한

 환경 변수 설정을 통해 

명령어 인식 오류를 

해결할 수 있었습니다.

 개발 과정에서 

마주하는 오류들은

 대부분 정확한 원인과 

해결 방법을 찾으면 

큰 어려움 없이

 해결할 수 있다는 점을 

다시 한 번 깨달았습니다.

728x90
728x90