Flutter Firebase 구글 로그인 트러블슈팅 정리
문제 1: 구글 로그인 버튼 클릭 시 앱 강제 종료
원인
Info.plist 파일에 REVERSED_CLIENT_ID 설정이 누락되었거나 잘못 입력된 경우 발생합니다.
해결 방법
GoogleService-Info.plist 파일을 열어 REVERSED_CLIENT_ID 값을 확인한 후, Xcode에서 Info.plist > URL Types에 해당 값을 등록합니다.
문제 2: Runner 앱 실행 시 “러너 응용 프로그램이 예기치 않게 종료되었습니다” 오류
원인
Xcode에서 애플 개발자 계정과 연결되지 않아 발생하는 문제입니다.
해결 방법
Xcode의 Signing & Capabilities 탭에서 Team을 본인의 Apple ID로 설정합니다. 테스트 목적이라면 무료 Apple ID로도 가능합니다.
문제 3: Xcode 빌드 오류 - No profiles for com.example.regionBasedChat were found
원인
실제 기기를 연결하지 않았고 Apple 개발자 계정에 디바이스 등록이 되어 있지 않기 때문에 발생합니다.
해결 방법
시뮬레이터로만 테스트할 경우 무시해도 무방합니다. 다만 실제 디바이스에 배포하려면 Apple Developer 계정과 디바이스 등록이 필요합니다.
문제 4: .gitignore 설정과 캐시 관련 파일 처리
설명
iOS와 Android 프로젝트에서는 빌드시 자동 생성되는 캐시 및 설정 파일들이 있습니다. 이 파일들은 GitHub에 업로드할 필요가 없습니다.
해결 방법
.gitignore 파일에 다음 항목들을 추가합니다.
# iOS
*.xcuserstate
DerivedData/
# Android
*.iml
.gradle/
build/
local.properties
.idea/
.cxx/문제 5: 커밋 메시지 길이에 대한 고민
설명
커밋 메시지는 팀원과의 협업을 위해 명확하고 목적이 분명하게 작성되어야 합니다.
해결 방법
커밋 메시지가 길어도 상관은 없지만, 핵심 내용이 잘 정리되어 있어야 좋습니다. 예: "Google 로그인 기능 구현 및 Info.plist 설정 오류 수정"
꼭 기억해야 할 사항 정리
GoogleService-Info.plist파일은.gitignore에 반드시 추가하고, 이미 커밋된 경우git rm --cached로 Git 캐시에서 제거해야 합니다.Signing & Capabilities의Team설정은 시뮬레이터 실행에도 영향을 줄 수 있습니다.- Apple 개발자 계정 없이도 시뮬레이터 테스트는 가능하지만, 실제 디바이스 빌드 및 배포는 불가능합니다.
- Firebase Console에서 Android와 iOS 앱 모두 화이트리스트에 등록되어 있어야 구글 로그인이 정상 동작합니다.
- Firebase에서 구글 로그인을 설정할 때, OAuth 리디렉션 URI가 정확하게 입력되어 있어야 합니다.
이 글은 Flutter로 Firebase 구글 로그인을 구현하면서 겪은 실제 문제 상황과 해결 경험을 기반으로 작성되었습니다. 비슷한 문제를 겪는 분들께 도움이 되기를 바랍니다.
