뚝딱뚝딱 모바일

[Flutter][Bug] 3.29.0 글자 깨지는 이슈 본문

Flutter 지식

[Flutter][Bug] 3.29.0 글자 깨지는 이슈

규석 2025. 4. 25. 16:44

3월에 마주친 이슈긴 한데, 기록해두면 좋을 것 같아 이제서야 적습니다...!
슬랙에 이러한 사진이 하나 올라왔습니다.

?????????

글자가 완전 뒤죽박죽 깨져있던 것이었습니다. API 응답값 문제 없고, 내 기기에서도 문제 없고... 도저히 알 수 없었던 상황이었습니다.

 

그래서 전 하나의 가설을 먼저 세웠습니다.

폰트 문제가 아닐까?

저희 앱은 Pretendard 폰트를 사용 중입니다. 이 폰트가 유저의 핸드폰에서 충돌이 난 것이 아닐까? 싶어 Pretendard 깃허브 issue들을 확인해보기 시작했습니다.

 

Variable font 사용시 특정 자음깨짐 현상 · Issue #177 · orioncactus/pretendard

안녕하세요. ㄴ, ㅅ, ㅊ 와 같은 자음이 깨지는 문제를 겪고 있습니다. 다른 variable font 파일(Noto Serif Variable)에서는 발생하지 않아서 이슈 남겨봅니다. 감사합니다.

github.com

뭔가 비슷한 이슈를 찾았습니다. Flutter + Android + 글자 깨짐. 완전 나랑 똑같잖아? 하고 쭉 살펴보다가 하나의 기시감이 들었습니다.

이 이슈에서 깨지는 모습은 글자 모양이 얼추 유지되어 있는데
사진의 이건 완전 도형처럼 보이는데...

 

설마 설마 싶어서 유저의 앱 버전, 저번 업데이트 때 적용된 것 중 문제가 갈만한 것을 확인하였습니다.

최신 버전 사용 중이셨고, 해당 버전은 Flutter 3.29.0 버전으로 마이그레이션한 버전이었습니다.

Flutter 버전 문제일 확률 88.7% (근거 없음)

Flutter 깃허브 issue를 쭉 찾아보니 아래 issue를 찾았습니다.

 

After upgrading to 3.29, the UI is broken. · Issue #163452 · flutter/flutter

After upgrading to 3.29, the UI is broken. If you touch the screen and move it, it returns to normal. I just uploaded the version and kept the source the same. device Android GalxxyS24+ Flutter 3.2...

github.com

저와 똑같은 문제의 이슈였습니다!

추측해보건데, 영어가 아닌 언어에서 간혈적으로 발생하던 문제인 것 같습니다.

 

Flutter 3.29.1 버전에서 해당 이슈를 해결했다고 하니, 바로 적용해주었고, 핫픽스 배포 이후 유저분의 글자 깨지는 문제가 해결된 것을 확인할 수 있었습니다!

 

혹시 Flutter에서 글자가 깨져서 이 글을 들어오셨다면, 먼저 SDK 버전을 확인해보시는 걸 추천합니다.