본문 바로가기
2026년 5월 8일2분 읽기

React Compiler 1.0 켰더니 useEffect가 무한 루프에 빠집니다

김
김영삼
조회 486댓글 6

React Compiler 1.0이 stable 됐길래 회사 프로덕트에 도입했는데, 일부 컴포넌트에서 무한 렌더링이 발생합니다. Compiler 끄면 멀쩡합니다.

환경: React 19.2, Next.js 16, react-compiler@1.0.0, eslint-plugin-react-compiler 설치

문제 코드 — 단순화한 형태:

function SearchBox({ onResult }) {
  const [query, setQuery] = useState('')

  useEffect(() => {
    if (!query) return
    fetch(`/api/search?q=${query}`)
      .then(r => r.json())
      .then(data => onResult({ items: data, query }))  // ← 매번 새 객체
  }, [query, onResult])

  return <input value={query} onChange={e => setQuery(e.target.value)} />
}

Compiler 켜기 전: 잘 됨

Compiler 켠 후: 첫 검색 후 무한 렌더링 → 브라우저 멈춤

onResult 콜백을 받는 부모에서 setState를 하는 구조인데, Compiler가 onResult 메모이제이션을 어떻게 처리하는지 모르겠습니다. Compiler 켠 채로 어떻게 해결하나요?

댓글 6

김김영삼6개월 전

전형적인 패턴입니다. useEffect 안에서 onResult를 호출 → 부모가 새 onResult 함수를 만들어 내림 → useEffect 재실행 → 무한 루프. Compiler가 부모의 onResult를 자동 메모이제이션 해줄 거라 기대했는데, 부모 쪽이 메모 가능한 형태가 아닐 가능성이 높습니다.


1단계 — eslint-plugin-react-compiler 출력 확인


가장 먼저 할 일입니다. 컴파일러가 "이 컴포넌트를 컴파일 안 했음" 또는 "여기서 메모이제이션 못 함"을 명시적으로 알려줍니다.


// eslint.config.js
import reactCompiler from 'eslint-plugin-react-compiler'

export default [
{
plugins: { 'react-compiler': reactCompiler },
rules: { 'react-compiler/react-compiler': 'error' },
},
]

위 코드를 lint 돌리면 "BailoutDueToUnknown / RefMutation / Hook called conditionally" 같은 메시지가 뜹니다. 컴파일러가 bailout 한 컴포넌트는 메모이제이션이 안 되어 기존 React와 동일하게 동작합니다.


2단계 — 부모 컴포넌트 형태 확인


SearchBox는 깔끔한데, 부모가 다음 같은 형태라면 컴파일러가 메모 못 합니다.


function Parent() {
const [results, setResults] = useState([])

// 이 함수가 매 렌더링마다 재생성됨
// Compiler가 자동 메모이제이션을 시도하지만, results 의존성이 매번 바뀌면 같은 결과
const handleResult = ({ items, query }) => {
setResults([...results, ...items]) // ← results를 직접 참조
}

return <SearchBox onResult={handleResult} />
}

여기서 handleResult가 results를 참조하니까, results가 바뀔 때마다 handleResult도 새로 만들어집니다. Compiler가 어찌할 수 없는 진짜 의존성입니다.


해결 — functional updater + useEffect 분리


// 부모
function Parent() {
const [results, setResults] = useState([])

const handleResult = ({ items }) => {
setResults(prev => [...prev, ...items]) // ← 함수형 업데이트
}
// 이제 handleResult는 results를 참조하지 않음 → 안정적

return <SearchBox onResult={handleResult} />
}

// 자식 — useEffect 의존성에서 onResult 제거 가능
function SearchBox({ onResult }) {
const [query, setQuery] = useState('')
const onResultRef = useRef(onResult)
useEffect(() => { onResultRef.current = onResult }, [onResult])

useEffect(() => {
if (!query) return
fetch(`/api/search?q=${query}`)
.then(r => r.json())
.then(data => onResultRef.current({ items: data, query }))
}, [query]) // ← onResult를 의존성에서 제외
}

onResultRef 패턴은 Compiler가 메모이제이션 못 하는 외부 콜백을 안전하게 호출하는 표준 방법입니다.


더 근본적으로는 "useEffect 안에서 외부 콜백 호출" 패턴 자체를 점검해보는 게 좋습니다. 보통 데이터 페칭은 SWR/React Query·Server Action으로 옮기면 이런 무한 루프가 구조적으로 사라집니다.

프프론트수진6개월 전

저희 팀도 Compiler 도입할 때 비슷한 케이스 5건쯤 만났는데, 패턴이 거의 정해져 있더라고요:



  1. useEffect 안에서 부모 콜백 호출 → 부모가 매번 새 콜백 (위 케이스)

  2. 스토어(zustand 등)의 selector가 매번 새 객체 반환 → re-subscribe 폭주

  3. 커스텀 hook 안에서 객체 리턴 → 부모가 그걸 useMemo 없이 사용 → 재렌더


그래서 도입 시 권장 절차:



  • 먼저 eslint-plugin-react-compiler를 warn 레벨로 도입 (error 아님)

  • 모든 bailout 경고를 1주일 동안 모음

  • 패턴별로 정리해서 한 번에 리팩토링

  • 그 다음 error 레벨로 승격 + Compiler 활성화


한 번에 다 켜면 어디서 터지는지 추적이 어려워서요. 작은 단위로 incremental하게 가는 게 안전합니다.

FFE팀리드(guest)6개월 전
Compiler 도입하면서 다른 케이스도 만났는데, 여기 답변과 비슷한 곳에서 막힙니다.
저희는 Next.js 16의 RSC + Compiler 조합인데, 서버 컴포넌트 안의 클라이언트 컴포넌트가 Compiler 적용을 받지 못하는 것 같습니다. 같은 client component를 일반 페이지에서 임포트하면 컴파일되는데, RSC 트리 안에서 임포트하면 안 됩니다.
이게 정상 동작인가요, 아니면 설정 빠진 건가요?
김김영삼6개월 전

좋은 케이스 보고 감사합니다. 결론부터: RSC 트리 안의 'use client' 컴포넌트도 동일하게 컴파일됩니다. 정상이 아닙니다.


다만 Next.js 16에서 흔한 함정이 있는데:


1) babel-plugin-react-compiler의 next.config.js 등록 누락


// next.config.js
module.exports = {
experimental: {
reactCompiler: true, // ← 이게 빠지면 RSC 모드에서 일부 컴포넌트 누락
},
}

2026년 5월 기준 reactCompiler: true는 SWC 통합이 GA지만, 일부 케이스에서 babel fallback이 필요합니다. next dev --turbo가 아닌 next dev로 한 번 돌려보면 차이가 보입니다.


2) opt-out 디렉티브 확인


해당 컴포넌트 파일 상단에 "use no memo"가 있는지 확인. 누가 디버깅용으로 넣어둔 게 남아있는 경우가 종종 있습니다.


3) 컴파일 결과 확인


가장 확실한 방법은 빌드 결과의 chunk를 직접 확인하는 겁니다.


// .next/static/chunks/ 안에서 해당 컴포넌트 검색
grep -l "MyComponent" .next/static/chunks/*.js
# 안에 _c1, _c2 같은 메모이제이션 캐시 식별자가 보이면 컴파일된 것

또는 React DevTools의 Profiler에서 "Why did this render?" 보면 메모이제이션 적용 여부가 보입니다.


위 셋 다 확인했는데도 컴파일 안 되면 react-compiler 이슈 트래커에 RSC 케이스 보고 부탁드립니다. 사례가 모이면 Meta 측에서 빠르게 패치합니다.

리리액트헌터(guest)6개월 전
OP입니다. functional updater + useRef 패턴으로 무한 루프는 잡았습니다.
그런데 SSR에서 다른 에러가 새로 떴어요:
Hydration failed because the server rendered text didn't match the client.
Server: "0 results"
Client: "12 results"
이건 Compiler 켠 후에만 발생합니다. fetch 응답을 useEffect로 받는데, Compiler가 어떤 형태로 SSR 결과를 만드는지 잘 모르겠어요. 어떻게 디버깅 시작하면 좋을까요?
풀풀스택지훈6개월 전

그건 Compiler 자체보다 SSR/CSR 차이 문제일 가능성이 큽니다. Compiler가 켜지면서 일부 effect 실행 순서가 바뀌어 노출되는 경우예요.


두 가지 점검:


1) 의심: useEffect 결과를 SSR에서 보고 있다?


SSR은 useEffect를 실행하지 않으므로 서버는 항상 "0 results"가 맞습니다. 클라이언트가 useEffect 실행 → fetch → 12개 결과로 업데이트. 이건 hydration mismatch가 아니라 정상 흐름이어야 하는데, 만약 메시지가 mismatch로 뜬다면 "마운트 전에 SSR 결과를 변경하려는 코드"가 있는 겁니다.


2) 권장 패턴 — Suspense + use()


fetch 자체를 서버 컴포넌트로 옮기면 hydration mismatch가 원천 차단됩니다.


// 서버 컴포넌트 (page.tsx)
async function SearchResults({ query }: { query: string }) {
const data = await search(query) // 서버에서 직접 호출
return <ResultList items={data} />
}

// 또는 client에서 use(promise) 활용
'use client'
import { use } from 'react'
function ResultList({ promise }) {
const data = use(promise)
return ...
}

useEffect 안에서 fetch 하는 패턴은 RSC 시대엔 가급적 피하는 게 좋아요. 정 써야 하면 서버에서는 빈 결과를 SSR하고, 클라이언트에서만 fetch + suppressHydrationWarning 패턴이 안전합니다.


일단 정확한 에러 위치는 React DevTools의 Hydration 탭에서 어떤 노드에서 mismatch가 났는지 보여줄 거예요. 거기서부터 추적하시면 됩니다.

Ctrl+Enter로 등록