본문 바로가기
Q&A2026년 5월 28일2분 읽기

React 19 Compiler 켰더니 useEffect가 dependency 누락 경고 — 어떻게 마이그레이션?

김
김준영
조회 370댓글 5

React 19 Compiler를 babel plugin으로 활성화했습니다. 기존 코드에서 useEffect 의존성 배열을 비워두거나 함수만 넣었던 패턴이 모두 경고 + 일부는 무한 루프로 빠집니다.

// 4 년 동안 잘 동작하던 코드
function Search({ query }: { query: string }) {
  const fetchData = async () => {
    const r = await fetch(`/api/search?q=${query}`)
    setResults(await r.json())
  }
  useEffect(() => { fetchData() }, [query])
  // ...
}

Compiler 켜고 나면 fetchData가 매번 새로 생성되는데, 어떤 케이스는 무한 루프, 어떤 케이스는 stale closure. Compiler가 자동 memoize하는 거 아니었나요?

전체 코드베이스 1,400개 컴포넌트인데 일일이 useCallback 감싸야 할까요?

환경: React 19.2, babel-plugin-react-compiler 1.0, Next.js 17

댓글 5

김김영삼5개월 전

React Compiler의 자동 memoization은 "함수 body가 같으면 같은 reference를 반환"이라는 보장이지, useEffect 의존성 배열까지 자동으로 무시해주진 않습니다. 여전히 의존성 명시는 필요합니다.


변화의 핵심


Compiler 이전 — fetchData가 매 렌더 새로 생성되니 의존성에 넣으면 무한 루프, 빼면 stale closure. 결국 useCallback 감싸야 했음.


Compiler 이후 — fetchData가 의존성 변화 없으면 같은 reference. 그래서 의존성에 넣어도 무한 루프 X. 그리고 stale closure도 자동 해결.


function Search({ query }: { query: string }) {
const fetchData = async () => {
const r = await fetch(`/api/search?q=${query}`)
setResults(await r.json())
}
// Compiler가 fetchData를 자동 memoize — query 변경 시에만 새 reference
useEffect(() => { fetchData() }, [fetchData]) // ← 이게 정답
}

왜 무한 루프?


Compiler가 활성화되지 않은 파일이 섞여 있거나, 컴포넌트가 Compiler가 변환할 수 없는 패턴(class component, ref mutation 등)을 포함하면 일부만 변환됩니다. 빌드 로그에 "Skipped: ..." 메시지를 찾아보세요.


점진 마이그레이션


1,400개 한 번에 켜지 마시고 디렉토리별로:


// babel.config.js
module.exports = {
plugins: [['react-compiler', {
sources: (filename) => filename.includes('src/components/v2/'),
}]],
}

새로 작성한 영역부터 Compiler ON, 검증되면 점진 확대. 한 번에 전체 ON은 사고 위험.

프프론트수진5개월 전

저희 팀도 같은 단계 거쳤어요. "use no memo" 디렉티브를 일부 컴포넌트에 임시로 박아두는 것도 방법입니다. Compiler 변환 자체를 컴포넌트 단위로 끌 수 있어요.


function ProblemComponent() {
"use no memo"
// 이 컴포넌트는 Compiler 적용 안 됨
...
}

점진 마이그레이션 중 임시 회피책으로 좋습니다.

준준희(guest)5개월 전
Strict Mode를 안 켜고 있었다면 Compiler 활성화하면서 같이 켜셔야 합니다. Strict Mode가 development에서 effect를 2번 실행해서 race condition 같은 잠재 버그 노출시킵니다. 그게 무한 루프처럼 보일 때도 있어요.
주주말코딩(guest)5개월 전
같은 고민 했었는데 결국 처음 admin 분 추천대로 가는 게 맞더라고요. 시도해본 결과 공유 감사합니다.
주주말코딩(guest)5개월 전
운영 6개월 경험인데 위에 적힌 함정 모두 거쳤습니다. 처음부터 정착 패턴 알았으면 좋았을 텐데...
Ctrl+Enter로 등록