← 전체 글로 돌아가기

Flutter

Flutter 리스트 성능 이슈 정리하기

Flutter에서 리스트 성능이 떨어질 때 배포 전에 확인할 체크리스트를 정리했다.

Flutter 개발하다 보면 로컬에서 괜찮던 설정도 배포 환경에서는 다르게 동작할 수 있다. 특히 리스트나 그리드 같은 대량 데이터를 다룰 때 성능 차이가 크게 나타난다.

모바일 앱의 성능 문제는 화면만 보고 판단할 수 없다. 실기기에서 로그를 직접 봐야 하고, 빌드 모드도 확인해야 한다.

사용자가 보는 모습

리스트 성능을 확인하려면 API 응답부터 확인해야 한다. 모바일 앱 전체 흐름에서 원인을 좁혀야 한다.

  • 먼저 확인: 빌드 모드, API 응답
  • 비교할 값: 정상일 때의 앱 상태
  • 남길 기록: 명령어 출력, 로그 메시지, 수정한 설정

개발자가 보는 신호

Flutter 문제는 화면만 보고 판단하면 놓친다. 로그, 응답, 설정 중 하나를 증거로 잡아야 한다.

flutter doctor -v
flutter run --verbose

빌드 모드에 따라 성능이 크게 달라진다. Release 모드와 Debug 모드를 모두 테스트해야 한다.

환경 차이 고려하기

로컬과 운영의 차이가 자주 숨어 있다. 환경 차이까지 같이 적어두면 원인 추적이 쉬워진다.

최종 확인

같은 조건에서 성능을 다시 측정해본다. 로그와 응답에서 달라진 부분을 설명할 수 있으면 충분히 정리된 것이다.

확인 순서:

  1. 같은 조건에서 증상이 다시 나오는지 테스트한다
  2. 로그나 응답에서 달라진 부분을 설명한다
  3. 공개 화면, 빌드 결과, 실제 요청으로 확인한다

다음을 위해

결과가 바뀐 이유를 로그와 응답으로 설명할 수 있으면 충분히 정리된 것이다. 관련 기록을 남겨두면 다음 확인이 훨씬 빨라진다.