MAUI CollectionView에서 OnBindingContextChanged 타이밍이 셀 상태를 망가뜨리는 구조적 이유와 해결 전략

서론

MAUI CollectionView를 사용하다 보면, 데이터는 정상인데 셀의 UI 상태가 뒤섞이거나 이전 항목의 값이 갑자기 나타나는 이상한 현상을 경험하게 된다.
특히 CheckBox, Switch, Entry 같은 상태 기반 컨트롤은 스크롤할 때마다 엉뚱한 값이 표시되며, UI가 번쩍이거나 초기값으로 되돌아가는 문제가 반복된다.

많은 개발자는 이를 단순히 “셀 재활용 이슈”라고 여기지만, 실제로는 훨씬 깊은 구조적 원인이 존재한다. 그 중심에 있는 것이 바로 OnBindingContextChanged()의 호출 타이밍 불일치 문제다.

이 메서드는 데이터가 실제로 변경되지 않았는데도 호출될 수 있으며, 어떤 경우에는 UI 초기화보다 먼저, 어떤 경우에는 나중에 실행된다. 그 결과, 셀 내부의 UI는 BindingContext 업데이트보다 앞서 초기화되거나, 이전 셀의 값을 유지한 채 새 데이터를 덮어쓰면서 상태가 꼬이게 된다.

이번 글에서는

• 왜 이런 타이밍 불일치가 발생하는지
• MAUI CollectionView 구조상 어떤 메커니즘이 작동하는지
• 실제로 개발자들이 겪는 오류가 어떻게 재현되는지
• 그리고 이 문제를 완전히 해결하기 위한 실전 전략은 무엇인지

를 깊이 있게 분석한다.

이 글은 CollectionView의 내부 구조를 정확히 이해하려는 개발자나
셀 재활용 때문에 UI가 망가져 스트레스를 받는 개발자에게
전문가 수준의 명확한 해답을 제공할 것이다.

 

요약 카드

제목
OnBindingContextChanged 타이밍이 CollectionView 셀 상태를 망가뜨리는 이유

요약

• CollectionView는 셀 재활용 과정에서 BindingContext를 여러 번 바꾸며 UI 초기화와 데이터 적용 시점이 어긋날 수 있다.
• OnBindingContextChanged는 데이터 변경이 없어도 호출되며, UI 초기화를 이 메서드에서 처리하면 상태 꼬임이 발생한다.
• 특히 CheckBox, Switch, Entry 등 상태 기반 UI는 이전 셀 값과 새 값이 혼합되는 문제가 자주 발생한다.
• 해결하려면 BindingContext null 체크, 모델 기반 UI 초기화, MVVM 상태 위임, 필요 시 RetainElement 전략을 적용해야 한다.
• 타이밍 불일치의 구조적 원인을 이해하면 셀 깜빡임, 값 꼬임, UI 불일치 문제를 근본적으로 해결할 수 있다.
•  

---

1. 문제 정의

MAUI CollectionView의 가장 골치 아픈 문제 중 하나는
셀 내부의 UI 상태가 데이터와 맞지 않게 섞이거나 꼬이는 현상이다.

특히 다음과 같은 상황이 흔하다.

• CheckBox가 갑자기 “다른 항목의 값”으로 표시됨
• ToggleSwitch가 이전 셀의 상태를 가져옴
• Entry 텍스트가 바뀌었는데 UI가 반영되지 않음
• 셀 재사용 시 Binding이 엉켜서 UI가 오작동

이 문제의 중심에는
OnBindingContextChanged() 호출 타이밍이 있다.

많은 개발자가 단순히 “셀 재활용 때문”이라고 말하지만,
진짜 원인은 MAUI가 BindingContext를 갱신하는 순서와 빈도에 있다.

---

2. 원인 분석

2.1 MAUI의 CollectionView는 재사용 구조를 기반으로 한다

CollectionView는 내부적으로 RecycleElement 전략을 사용한다.

이는 다음 순서를 따른다.

 

1. 기존 셀을 재활용함 2. 새로운 BindingContext를 셀에 부여 3. OnBindingContextChanged가 호출됨 4. UI가 이전 상태를 유지한 채 새 데이터를 반영하려고 시도함

문제는 2 → 3 → 4 과정의 타이밍이 일정하지 않다는 것이다.
플랫폼마다 다르고, 스크롤 속도나 항목 수에 따라 흔들린다.

---

2.2 OnBindingContextChanged는 생각보다 “자주” 호출된다

다음 상황에서도 호출된다.

• 아이템이 화면에 처음 나타날 때
• 스크롤로 인해 셀이 재활용될 때
• ObservableCollection 변경 시
• 부모 레이아웃이 재측정될 때
• VisualState가 변경될 때
• Template 재화면 출력 시

즉,

OnBindingContextChanged는 데이터가 바뀌지 않아도 호출될 수 있다.

이 점을 모르고 코드에서 각종 초기화를 하면 문제가 발생한다.

---

2.3 UI 상태 초기화가 “Binding보다 빨리 실행되는 경우”

핵심 문제는 이것이다.

• BindingContext가 바뀌었다
• OnBindingContextChanged가 실행된다
• UI 초기화를 한다
• 그러나 Binding은 아직 업데이트되지 않았다

즉
UI 초기화 시점과 Binding 적용 시점이 어긋난다.

결과적으로 다음 문제가 생긴다.

• CheckBox가 ‘이전 상태 → 초기화된 상태 → 새 값’으로 여러 번 변함
• Switch가 깜빡임
• Entry 텍스트가 데이터와 맞지 않음
• UI가 이전 셀 값과 섞임

---

3. 구조적 문제 예시 코드

 

protected override void OnBindingContextChanged()
{
    base.OnBindingContextChanged();

    // ❌ 잘못된 패턴: 데이터와 무관하게 항상 UI 초기화
    CheckBox.IsChecked = false;

    // ❌ 또는 강제 색상, 강제 값 설정
    TitleLabel.TextColor = Colors.Black;
}

 

 

이 코드는
BindingContext가 아직 적용되지 않은 상태에서 UI를 초기화해버린다.

따라서 실제 데이터가 들어오기 전에 UI 상태가 한번 “꼬인다”.

---

4. 해결 전략

✔ 전략 1

UI 초기화를 해야 한다면 “데이터가 null인지 검사”

BindingContext가 실제 모델인지 먼저 확인한다.

 

protected override void OnBindingContextChanged()
{
    base.OnBindingContextChanged();

    if (BindingContext is not MyItemModel model)
        return;

    // 여기부터가 진짜 안전한 초기화 구간
}

 

 

데이터 없는 상태에서 UI 초기화를 절대 하지 않는 것이 핵심이다.

---

✔ 전략 2

UI 상태는 “데이터 기반”으로만 설정

절대 UI 초기 상태를 직접 넣지 말고
모델의 값에 의존해야 한다.

예

 

CheckBox.IsChecked = model.IsSelected;
TitleLabel.Text = model.Title;

 

 

UI 상태는 항상 “모델로부터 온다”는 원칙을 지켜야 한다.

---

✔ 전략 3

상태 초기화는 OnBindingContextChanged가 아닌 “셀 생성 시 1회만”

XAML의 Template를 최소화하고
상태는 처음 생성 시만 초기화한다.

MAUI에서는 “셀 생성” 시점을 감지하기 어려워 보이지만
핸들러를 사용하면 가능하다.

---

✔ 전략 4

가능한 경우 MVVM 방식으로 상태를 완전히 모델에 위임

UI에서 강제 조작하는 코드를 최소화한다.

예를 들어 CheckBox는
IsChecked 바인딩만 유지하고
클릭 이벤트 로직은 ViewModel이 처리하는 방식.

---

✔ 전략 5

RecycleElement → RetainElement로 변경 검토

성능은 떨어지지만
상태 꼬임 문제는 거의 사라진다.

 

<CollectionView ItemsLayout="VerticalList"
                ItemTemplate="{StaticResource MyTemplate}"
                ItemSizingStrategy="MeasureAllItems"
                RecyclingStrategy="RetainElement" />

 

 

상황에 따라 매우 효과적이다.

---

5. 결론

MAUI CollectionView에서 발생하는
셀 상태 꼬임, 깜빡임, 잘못된 UI 표시 문제의 중심에는

OnBindingContextChanged 호출 타이밍과 Binding 적용 타이밍의 불일치

가 있다.

이를 해결하기 위해서는

• BindingContext null 체크
• UI 초기화 금지
• 모델 기반 상태 관리
• MVVM 기반 로직 위임
• RetainElement 고려

같은 전략을 적용해야 한다.

이 주제는
CollectionView를 깊이 이해해야만 다룰 수 있는 전문가 영역이며
MAUI 개발자들이 실제로 겪는 난제다.