FlatList 최적화 방법 — 성능 문제의 원인부터 실전 기법까지
React Native로 대용량 리스트를 구현할 때 가장 먼저 만나는 컴포넌트가 FlatList입니다. 그런데 아이템이 많아질수록 스크롤이 버벅이거나, 빠르게 스크롤하면 빈 영역이 보이거나, 메모리가 치솟는 문제를 경험하게 됩니다. 이 글에서는 FlatList가 내부적으로 어떻게 동작하는지 이해하고, 각 최적화 기법이 왜 효과적인지 원리부터 설명합니다.
1. FlatList의 동작 원리
FlatList는 VirtualizedList의 래퍼 컴포넌트입니다. "Virtualized"라는 이름에서 알 수 있듯, 핵심 아이디어는 전체 데이터를 한 번에 렌더링하지 않고 viewport 근처의 아이템만 마운트하는 것입니다.
┌─────────────────────────────┐
│ window │ ← 마운트된 아이템 영역
│ ┌───────────────────────┐ │
│ │ │ │
│ │ viewport │ │ ← 실제 화면에 보이는 영역
│ │ │ │
│ └───────────────────────┘ │
│ │
└─────────────────────────────┘
아래: 아직 마운트되지 않음
| 용어 | 설명 |
|---|---|
| viewport | 현재 화면에 보이는 픽셀 영역 |
| window | 아이템이 마운트되는 영역. viewport보다 크며 기본값은 viewport의 21배 |
| blank area | 스크롤 속도가 렌더링 속도를 초과했을 때 아이템이 없는 빈 영역 |
스크롤할 때 window 범위를 벗어난 아이템은 언마운트되고, 새로 window 안으로 들어오는 아이템은 마운트됩니다. 이 메커니즘이 메모리를 절약하지만, 동시에 blank area와 렌더링 지연의 원인이 되기도 합니다.
2. 성능 문제의 두 가지 축
FlatList 최적화는 두 가지 상충 관계를 조율하는 작업입니다.
| 문제 | 원인 | 해결 방향 | 부작용 |
|---|---|---|---|
| blank area | 렌더링이 스크롤을 따라가지 못함 | window 크게, 배치 많게 | 메모리 증가, JS 부담 |
| 메모리 / 반응성 저하 | 너무 많은 아이템이 동시에 마운트됨 | window 작게, 배치 적게 | blank area 증가 |
앱의 특성(아이템 크기, 데이터 양, 타겟 기기)에 따라 두 축의 균형점을 찾아야 합니다.
3. Props 최적화
getItemLayout — 레이아웃 측정 비용 제거
FlatList는 기본적으로 각 아이템을 렌더링하면서 높이를 측정합니다. 아이템 높이가 고정되어 있다면 getItemLayout을 제공해 이 측정 과정을 완전히 생략할 수 있습니다.
const ITEM_HEIGHT = 80;
const SEPARATOR_HEIGHT = 1;
<FlatList
data={items}
renderItem={renderItem}
getItemLayout={(data, index) => ({
length: ITEM_HEIGHT,
offset: (ITEM_HEIGHT + SEPARATOR_HEIGHT) * index,
index,
})}
/>getItemLayout을 적용하면 두 가지 효과가 있습니다:
- 초기 렌더링 속도 향상: 레이아웃 측정 없이 즉시 올바른 위치로 렌더링
scrollToIndex정확도 향상: 오프셋을 미리 알기 때문에 렌더 window 밖으로도 정확하게 스크롤 가능
ItemSeparatorComponent를 사용한다면 offset 계산에 separator 높이를 반드시 포함해야 합니다.
initialNumToRender — 초기 렌더링 아이템 수 조정
앱이 처음 마운트될 때 렌더링할 아이템 수입니다. 기본값은 10이지만, 화면을 딱 채울 만큼만 설정하는 것이 이상적입니다.
// 기기 높이와 아이템 높이를 기준으로 계산
import { Dimensions } from 'react-native';
const SCREEN_HEIGHT = Dimensions.get('window').height;
const ITEM_HEIGHT = 80;
const INITIAL_NUM = Math.ceil(SCREEN_HEIGHT / ITEM_HEIGHT) + 2;
<FlatList
data={items}
renderItem={renderItem}
initialNumToRender={INITIAL_NUM}
/>- 너무 작으면: 초기 화면에 blank area 발생
- 너무 크면: 불필요한 아이템을 초기에 마운트해 앱 시작이 느려짐
windowSize — 마운트 영역 크기 조정
windowSize는 viewport 높이를 단위(1)로 하여 마운트 영역의 크기를 결정합니다. 기본값 21은 현재 위치 위로 10개 viewport, 아래로 10개 viewport를 마운트한다는 의미입니다.
// 메모리를 아끼고 싶다면 줄이기 (blank area 위험 증가)
<FlatList windowSize={5} data={items} renderItem={renderItem} />
// blank area를 줄이고 싶다면 늘리기 (메모리 증가)
<FlatList windowSize={41} data={items} renderItem={renderItem} />저사양 기기를 지원한다면 windowSize를 줄여 메모리 절약을 우선시하는 것이 합리적입니다.
maxToRenderPerBatch + updateCellsBatchingPeriod — 렌더 배치 세부 조정
스크롤 중에 FlatList는 일정 간격으로 새 아이템을 배치 렌더링합니다. 이 두 props로 배치의 크기와 빈도를 제어합니다.
| Prop | 기본값 | 의미 |
|---|---|---|
maxToRenderPerBatch | 10 | 한 번의 배치에 렌더링할 최대 아이템 수 |
updateCellsBatchingPeriod | 50ms | 배치 사이의 대기 시간 |
// 빠른 스크롤에서 blank area가 자주 보인다면: 배치당 아이템 늘리기
<FlatList
data={items}
renderItem={renderItem}
maxToRenderPerBatch={20}
updateCellsBatchingPeriod={30}
/>// 스크롤 중 터치 반응이 느리다면: 배치당 아이템 줄이기
<FlatList
data={items}
renderItem={renderItem}
maxToRenderPerBatch={5}
updateCellsBatchingPeriod={100}
/>두 값을 함께 조정해 "더 많은 아이템을 더 낮은 빈도로" 또는 "더 적은 아이템을 더 높은 빈도로" 조합할 수 있습니다.
removeClippedSubviews — native view 분리
viewport 밖의 뷰를 native 렌더링 트리에서 분리하는 옵션입니다. Android에서는 기본값이 true입니다.
<FlatList
data={items}
renderItem={renderItem}
removeClippedSubviews={true}
/>- 장점: main thread의 native 렌더링 비용을 줄여 프레임 드롭 위험 감소
- 단점:
transform이나absolutepositioning을 복잡하게 사용할 경우 iOS에서 콘텐츠가 사라지는 버그 발생 가능
이 prop은 뷰를 할당 해제하지 않고 분리하므로 메모리 절약 효과는 미미합니다. 프레임 드롭 개선에 초점을 맞춘 옵션입니다.
4. renderItem 최적화
익명 함수 지양 + useCallback 적용
renderItem에 인라인 익명 함수를 전달하면 부모 컴포넌트가 re-render될 때마다 새 함수 참조가 생성됩니다. FlatList는 PureComponent이므로 props 참조가 변경되면 내부 아이템 전체가 다시 평가됩니다.
// ❌ 매 render마다 새 함수 생성
const PostList = ({ posts }: { posts: Post[] }) => (
<FlatList
data={posts}
renderItem={({ item }) => <PostCard post={item} />}
/>
);// ✅ useCallback으로 함수 참조 안정화
interface Post {
id: string;
title: string;
body: string;
}
const PostList = ({ posts }: { posts: Post[] }) => {
const renderPost = useCallback(
({ item }: { item: Post }) => <PostCard post={item} />,
[],
);
return <FlatList data={posts} renderItem={renderPost} />;
};keyExtractor 안정적으로 설정
keyExtractor도 마찬가지로 인라인 함수 대신 안정된 참조를 사용하세요.
// ❌ 인라인 — 매 render마다 재생성
<FlatList keyExtractor={(item) => item.id} ... />
// ✅ 컴포넌트 외부에 선언
const keyExtractor = (item: Post) => item.id;
const PostList = ({ posts }: { posts: Post[] }) => (
<FlatList data={posts} keyExtractor={keyExtractor} renderItem={renderPost} />
);5. 리스트 아이템 컴포넌트 최적화
React.memo로 불필요한 re-render 방지
FlatList가 re-render되면 각 renderItem 호출로 아이템 컴포넌트도 다시 평가됩니다. React.memo로 감싸면 props가 실제로 변경될 때만 re-render됩니다.
interface PostCardProps {
id: string;
title: string;
thumbnailUrl: string;
likeCount: number;
}
export const PostCard = memo(
({ id, title, thumbnailUrl, likeCount }: PostCardProps) => {
return (
<View style={styles.card}>
<Image source={{ uri: thumbnailUrl }} style={styles.thumbnail} />
<View style={styles.content}>
<Text style={styles.title}>{title}</Text>
<Text style={styles.likes}>{likeCount} likes</Text>
</View>
</View>
);
},
(prev, next) =>
prev.id === next.id &&
prev.title === next.title &&
prev.thumbnailUrl === next.thumbnailUrl &&
prev.likeCount === next.likeCount,
);두 번째 인수로 전달한 비교 함수가 true를 반환하면 re-render를 건너뜁니다. 모든 props를 비교하는 기본 동작(인수 생략 시)보다 비교해야 할 항목을 직접 지정하면 비교 비용도 줄일 수 있습니다.
컴포넌트 구조 단순화
아이템 컴포넌트가 복잡할수록 렌더링 시간이 길어집니다.
// ❌ 리스트 아이템에 너무 많은 정보
export const PostCard = memo(({ post }: { post: Post }) => (
<View>
<UserAvatar user={post.author} size="large" showFollowButton />
<HeroImage uri={post.imageUrl} enableZoom />
<RichTextRenderer content={post.body} />
<ReactionBar post={post} showAllReactions />
<CommentPreview comments={post.recentComments} />
</View>
));
// ✅ 리스트는 최소 정보만, 상세는 detail 화면에서
export const PostCard = memo(({ post }: { post: Post }) => (
<View style={styles.card}>
<Image source={{ uri: post.thumbnailUrl }} style={styles.thumbnail} />
<Text style={styles.title} numberOfLines={2}>{post.title}</Text>
<Text style={styles.meta}>{post.author.name} · {post.likeCount} likes</Text>
</View>
));아이템 타입별 분리 (getItemType)
여러 종류의 아이템(예: 텍스트 포스트, 이미지 포스트, 광고)이 섞인 리스트는 타입별로 다른 컴포넌트를 렌더링합니다. 이때 타입을 명시하면 FlatList가 재사용 가능한 셀을 타입별로 관리해 렌더링 효율을 높입니다.
이 기능은 FlashList의
getItemTypeprop에서 더 효과적으로 지원됩니다. (8절 참고)
6. 이미지 최적화
리스트 아이템에 이미지가 많다면 이미지 로딩이 JS thread를 차지하는 주요 원인이 됩니다.
썸네일 사용
// ❌ 원본 고해상도 이미지를 리스트에 직접 사용
<Image source={{ uri: post.originalImageUrl }} style={{ width: 60, height: 60 }} />
// ✅ 리스트용으로 리사이즈된 썸네일 사용
<Image source={{ uri: post.thumbnailUrl }} style={{ width: 60, height: 60 }} />react-native-fast-image 활용
기본 Image 컴포넌트는 캐싱과 메모리 관리가 제한적입니다. @d11/react-native-fast-image는 네이티브 레벨의 이미지 캐싱을 제공해 리스트 스크롤 시 이미지 플리커링과 재다운로드를 방지합니다.
import FastImage from '@d11/react-native-fast-image';
export const PostCard = memo(({ post }: { post: Post }) => (
<View style={styles.card}>
<FastImage
style={styles.thumbnail}
source={{
uri: post.thumbnailUrl,
priority: FastImage.priority.normal,
cache: FastImage.cacheControl.immutable,
}}
resizeMode={FastImage.resizeMode.cover}
/>
<Text style={styles.title}>{post.title}</Text>
</View>
));7. extraData로 불필요한 re-render 제어
FlatList는 PureComponent이므로 data prop이 동일하면 re-render되지 않습니다. renderItem이 data 외부의 상태(예: 선택된 아이템 ID)를 참조한다면 extraData에 전달해야 합니다.
// ❌ selectedId가 변경되어도 FlatList가 re-render되지 않음
const PostList = ({ posts }: { posts: Post[] }) => {
const [selectedId, setSelectedId] = useState<string | null>(null);
return (
<FlatList
data={posts}
renderItem={({ item }) => (
<PostCard post={item} isSelected={item.id === selectedId} />
)}
/>
);
};// ✅ extraData에 외부 상태 전달
const PostList = ({ posts }: { posts: Post[] }) => {
const [selectedId, setSelectedId] = useState<string | null>(null);
const renderItem = useCallback(
({ item }: { item: Post }) => (
<PostCard
post={item}
isSelected={item.id === selectedId}
onPress={() => setSelectedId(item.id)}
/>
),
[selectedId],
);
return (
<FlatList
data={posts}
renderItem={renderItem}
keyExtractor={(item) => item.id}
extraData={selectedId}
/>
);
};extraData가 변경되면 FlatList가 전체를 re-render 대상으로 인식합니다. 여러 외부 상태가 있다면 객체로 묶어 전달하세요.
extraData={{ selectedId, editMode, theme }}8. FlashList — FlatList의 한계를 넘는 대안
FlatList의 근본적인 한계는 아이템을 재사용하지 않는다는 점입니다. 스크롤 밖으로 나간 아이템은 언마운트되고, 새로 들어오는 아이템은 처음부터 마운트됩니다.
Shopify의 FlashList는 Cell Recycling 방식으로 이 문제를 해결합니다. 기존에 사용된 뷰를 재사용하고 그 안의 데이터만 갱신하므로, 마운트/언마운트 비용이 사라집니다.
FlatList → FlashList 마이그레이션
API가 거의 동일해 교체가 매우 간단합니다.
npm install @shopify/flash-list// Before
import { FlatList } from 'react-native';
<FlatList
data={posts}
renderItem={renderItem}
keyExtractor={(item) => item.id}
/>// After
import { FlashList } from '@shopify/flash-list';
<FlashList
data={posts}
renderItem={renderItem}
keyExtractor={(item) => item.id}
estimatedItemSize={80}
/>estimatedItemSize는 렌더 전에 레이아웃을 예측하기 위한 추정값입니다. 정확할수록 좋지만 getItemLayout처럼 정확하지 않아도 동작합니다.
이종 아이템 타입 최적화
서로 다른 구조의 아이템이 섞인 리스트라면 getItemType으로 타입별 recycling pool을 분리해야 합니다. 타입이 다른 셀끼리 재사용하면 레이아웃이 깨질 수 있습니다.
type FeedItem =
| { type: 'post'; id: string; title: string; thumbnailUrl: string }
| { type: 'ad'; id: string; imageUrl: string; cta: string };
const renderItem = ({ item }: { item: FeedItem }) => {
if (item.type === 'post') return <PostCard post={item} />;
return <AdBanner ad={item} />;
};
<FlashList
data={feedItems}
renderItem={renderItem}
keyExtractor={(item) => item.id}
getItemType={(item) => item.type}
estimatedItemSize={80}
/>FlatList vs FlashList 비교
| 항목 | FlatList | FlashList |
|---|---|---|
| 렌더링 방식 | 마운트 / 언마운트 | Cell Recycling |
| 고정 아이템 크기 최적화 | getItemLayout 필수 | estimatedItemSize (추정값 OK) |
| 이종 아이템 타입 | 지원 미흡 | getItemType으로 타입별 pool 분리 |
| blank area | 저사양 기기에서 자주 발생 | 개선됨 |
| FPS (저사양 기기) | 저하될 수 있음 | 60 FPS 달성 목표 |
| 메모리 buffer | 기본 windowSize 기반 (큼) | 기본 250px (작음) |
| API 호환성 | — | FlatList API와 거의 동일 |
9. 최적화 체크리스트
Props
- 아이템 높이가 고정이라면
getItemLayout설정 -
initialNumToRender를 화면을 채울 적정 수로 설정 -
windowSize를 앱 특성에 맞게 조정 (기본값 21) - blank area가 보인다면
maxToRenderPerBatch증가 - 터치 반응이 느리다면
maxToRenderPerBatch감소 - Android에서
removeClippedSubviews={true}확인 (기본값)
컴포넌트
-
renderItem을useCallback으로 감싸기 -
keyExtractor를 컴포넌트 외부에 선언 - 아이템 컴포넌트를
React.memo로 감싸기 -
extraData로 외부 상태 변화를 FlatList에 전달 - 아이템 컴포넌트의 JSX 중첩 최소화
- 리스트에는 썸네일 이미지 사용, 상세 정보는 detail 화면으로
고려 사항
- 아이템이 100개 이상이고 성능 문제가 있다면 FlashList 마이그레이션 검토
- 이종 아이템이 있다면 FlashList의
getItemType활용 - 저사양 Android 기기에서 반드시 테스트
FlatList 최적화는 단일 설정으로 해결되지 않습니다. 앱의 아이템 크기, 데이터 양, 타겟 기기를 고려해 각 Props를 조정하고, 컴포넌트 레벨에서 불필요한 re-render를 줄이는 두 방향을 함께 접근해야 합니다. 근본적인 성능 개선이 필요하다면 FlashList로의 전환이 가장 효과적인 선택입니다.