Flutter SDK 버전 오류 트러블슈팅: Dart SDK 버전 불일치

 문제 상황

 

Flutter 프로젝트 실행 또는 flutter pub get 실행 시 다음과 같은 오류가 발생했다:

The current Dart SDK version is 3.5.0.

Because todo_mvvm_riverpod requires SDK version >=3.6.0 <4.0.0, version solving failed.

 

• pubspec.yaml에는 Dart 3.6 이상이 명시되어 있었음.
• flutter --version은 3.32.8 (Dart 3.8.1 포함)로 출력되었음.
• 하지만 flutter pub get 명령 실행 시 여전히 Dart 3.5.0 기준으로 동작함.

 

---

 

원인 분석

 

• 시스템 Flutter와 FVM으로 설치한 Flutter가 혼재되어 있었음.
• 프로젝트 디렉토리에 FVM 버전 지정이 없어서 flutter 명령이 시스템 기본 Flutter (Dart 3.5.0 포함)를 참조함.

 

---

 

 시도한 방법

 

• flutter upgrade
• flutter doctor
• brew install fvm
• fvm install 3.32.8
• flutter --version으로 버전 확인 → 정상적으로 3.32.8 출력됨
• .zshrc에 경로 지정
• export PATH="$PATH":"$HOME/fvm/default/bin"

 

그러나 여전히 pub get 시에는 Dart 3.5.0 기준으로 실행됨.

 

---

 

✅해결 방법

fvm use 3.32.8

해당 명령을 프로젝트 루트 디렉토리에서 실행함으로써, .fvm 폴더와 .metadata가 자동으로 설정됨. 이후 flutter pub get이 Dart 3.8.1 기준으로 동작하면서 문제 해결됨.

 

---

 

향후 고려사항 및 팁

 

1. 프로젝트마다 fvm use <버전>로 버전 고정하기
2. .vscode/settings.json에 다음 항목 추가:

{
  "dart.flutterSdkPath": ".fvm/flutter_sdk"
}

 

1. → VS Code에서도 FVM 버전 참조 가능
2. .fvm 폴더와 .vscode 폴더는 .gitignore에 추가하지 말고 버전 관리할 것
3. 시스템 전역 Flutter는 최신으로 유지하되, 프로젝트 별로 FVM 사용 권장