Flutter 배포 후 문제 추적하는 실전 방법

Flutter 앱은 로컬에서 잘 돌다가도 배포 환경에서 갑자기 문제가 생기곤 한다. 이런 상황을 만나면 먼저 화면에 보이는 에러만 보지 말고, 정상 상태가 뭔지 먼저 정해두는 게 중요하다.

배포 환경에서 처음 확인할 것

문제가 생기면 일단 재현이 가능한지부터 확인하는 게 핵심이다. 같은 상황에서 문제가 반복되는지, 아니면 한 번만 나타나는 건지에 따라 원인을 좁히는 속도가 크게 달라진다.

• 먼저 볼 값: 발생 시점과 환경(OS, 기기, 네트워크)
• 같이 비교할 값: 로컬과 배포 환경의 설정 차이
• 기록해둘 것: 에러 메시지, 로그 출력, 변경 사항

로그를 읽는 우선순위

Flutter 로그는 양이 많아서 어디부터 봐야 할지 막힐 때가 있다. 배포 환경의 로그를 볼 때는 시간대를 먼저 맞춘 다음, 그 시점 근처의 에러나 경고만 골라낸다. 네트워크 요청이라면 응답 코드도 함께 확인한다.

# 실시간 로그 보기
adb logcat | grep -i flutter

# 최근 로그 100줄 보기
adb logcat -d | tail -100

환경 차이를 명확히 해두기

같은 코드인데도 로컬과 배포에서 다르게 동작하는 경우가 많다. 권한, 캐시, 네트워크 타임아웃, API 엔드포인트 같은 설정이 달라질 때가 대부분이다. 문제를 추적할 때는 이런 차이들을 한 줄씩 명시해 두는 게 좋다.

한 번에 하나씩만 바꾸기

원인을 찾으려다가 여러 설정을 동시에 바꾸면, 뭐가 진짜 원인인지 나중에 모호해진다. 가설을 세운 후 그것만 바꿔보고, 문제가 해결되는지 확인한다. 안 되면 다시 원래대로 돌리고 다음 것을 시도한다.

마지막 확인은 실제 기기에서

아무리 로컬에서 완벽해 보여도, 실제 사용자가 쓸 기기에서 한 번 더 확인해야 한다. 테스트폰이나 베타 사용자의 피드백에서 예상 못 한 조건들이 자주 나온다. 문제를 해결한 후에는 같은 조건을 기록해 두면, 다음 번에 비슷한 증상이 나올 때 훨씬 빨리 대응할 수 있다.