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
전형적인 패턴입니다. useEffect 안에서 onResult를 호출 → 부모가 새 onResult 함수를 만들어 내림 → useEffect 재실행 → 무한 루프. Compiler가 부모의 onResult를 자동 메모이제이션 해줄 거라 기대했는데, 부모 쪽이 메모 가능한 형태가 아닐 가능성이 높습니다.
1단계 — eslint-plugin-react-compiler 출력 확인
가장 먼저 할 일입니다. 컴파일러가 "이 컴포넌트를 컴파일 안 했음" 또는 "여기서 메모이제이션 못 함"을 명시적으로 알려줍니다.
위 코드를 lint 돌리면 "BailoutDueToUnknown / RefMutation / Hook called conditionally" 같은 메시지가 뜹니다. 컴파일러가 bailout 한 컴포넌트는 메모이제이션이 안 되어 기존 React와 동일하게 동작합니다.
2단계 — 부모 컴포넌트 형태 확인
SearchBox는 깔끔한데, 부모가 다음 같은 형태라면 컴파일러가 메모 못 합니다.
여기서 handleResult가 results를 참조하니까, results가 바뀔 때마다 handleResult도 새로 만들어집니다. Compiler가 어찌할 수 없는 진짜 의존성입니다.
해결 — functional updater + useEffect 분리
onResultRef 패턴은 Compiler가 메모이제이션 못 하는 외부 콜백을 안전하게 호출하는 표준 방법입니다.
더 근본적으로는 "useEffect 안에서 외부 콜백 호출" 패턴 자체를 점검해보는 게 좋습니다. 보통 데이터 페칭은 SWR/React Query·Server Action으로 옮기면 이런 무한 루프가 구조적으로 사라집니다.
저희 팀도 Compiler 도입할 때 비슷한 케이스 5건쯤 만났는데, 패턴이 거의 정해져 있더라고요:
그래서 도입 시 권장 절차:
한 번에 다 켜면 어디서 터지는지 추적이 어려워서요. 작은 단위로 incremental하게 가는 게 안전합니다.
저희는 Next.js 16의 RSC + Compiler 조합인데, 서버 컴포넌트 안의 클라이언트 컴포넌트가 Compiler 적용을 받지 못하는 것 같습니다. 같은 client component를 일반 페이지에서 임포트하면 컴파일되는데, RSC 트리 안에서 임포트하면 안 됩니다.
이게 정상 동작인가요, 아니면 설정 빠진 건가요?
좋은 케이스 보고 감사합니다. 결론부터: RSC 트리 안의 'use client' 컴포넌트도 동일하게 컴파일됩니다. 정상이 아닙니다.
다만 Next.js 16에서 흔한 함정이 있는데:
1) babel-plugin-react-compiler의 next.config.js 등록 누락
2026년 5월 기준
reactCompiler: true는 SWC 통합이 GA지만, 일부 케이스에서 babel fallback이 필요합니다.next dev --turbo가 아닌next dev로 한 번 돌려보면 차이가 보입니다.2) opt-out 디렉티브 확인
해당 컴포넌트 파일 상단에
"use no memo"가 있는지 확인. 누가 디버깅용으로 넣어둔 게 남아있는 경우가 종종 있습니다.3) 컴파일 결과 확인
가장 확실한 방법은 빌드 결과의 chunk를 직접 확인하는 겁니다.
또는 React DevTools의 Profiler에서 "Why did this render?" 보면 메모이제이션 적용 여부가 보입니다.
위 셋 다 확인했는데도 컴파일 안 되면 react-compiler 이슈 트래커에 RSC 케이스 보고 부탁드립니다. 사례가 모이면 Meta 측에서 빠르게 패치합니다.
그런데 SSR에서 다른 에러가 새로 떴어요:
Hydration failed because the server rendered text didn't match the client.
Server: "0 results"
Client: "12 results"
이건 Compiler 켠 후에만 발생합니다. fetch 응답을 useEffect로 받는데, Compiler가 어떤 형태로 SSR 결과를 만드는지 잘 모르겠어요. 어떻게 디버깅 시작하면 좋을까요?
그건 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가 원천 차단됩니다.
useEffect 안에서 fetch 하는 패턴은 RSC 시대엔 가급적 피하는 게 좋아요. 정 써야 하면 서버에서는 빈 결과를 SSR하고, 클라이언트에서만 fetch + suppressHydrationWarning 패턴이 안전합니다.
일단 정확한 에러 위치는 React DevTools의 Hydration 탭에서 어떤 노드에서 mismatch가 났는지 보여줄 거예요. 거기서부터 추적하시면 됩니다.